SPF Map Origin & Seam Detector 插件

一款专为 American Truck Simulator 和 Euro Truck Simulator 2 设计的专业诊断插件，用于识别当前地图区域的来源（Mod 或 DLC）。它配备了先进的 **Map Seam Detector**，可用于可视化不同地图 Mod 之间的过渡。 ## 🎓 演示目的 本项目演示了针对游戏虚拟文件系统 (VFS) 的高级逆向工程技术： * **VFS Pool 迭代**：扫描 Mod、SCS 和 Base pool 以解析文件优先级。 * **逆向优先级识别**：实现“赢家通吃”逻辑，以找到当前生效的区域覆盖。 * **动态区域映射**：将地图坐标实时计算为游戏内的 5120x5120 区域网格。 * **基于 Pattern 的内存发现**：无需硬编码地址即可找到 VFS 标记和地图路径指针。 ## 功能 * **区域归属识别**：瞬间揭示当前你所在的区域归属于哪个 Mod 或 DLC。 * **完整的 Archive Stack**：列出包含当前区域文件的每一个 archive（SCS 或 Mod）。 * **四向接缝检测器**：扫描北、南、东、西四个方向的相邻区域，以查找 Mod 之间的过渡。 * **可视化状态指示器**： * `[SAME]`：相邻区域属于同一个 Mod。 * `[BASE]`：相邻区域是原版游戏或官方 DLC 的一部分。 * `[SEAM]`：相邻区域属于**不同的 Mod**（检测到接缝！）。 * `[VOID]`：相邻区域为空（地图边缘）。 * **通用地图支持**：直接从内存中自动检测地图名称（usa、europe、promods 等）。 ## 如何构建 🛠️ 这是一个标准的 CMake 项目。要从源码构建： 1. 克隆本仓库。 2. 确保你已安装 **CMake** 和 **Visual Studio (MSVC)**。 3. 创建一个 `build` 目录。 4. 运行 `cmake ..`，然后运行 `cmake --build .`。 ## 安装说明 ### 前置条件 你必须安装 **SPF Framework**。 * **[在此下载 SPF-Framework](https://github.com/TrackAndTruckDevs/SPF-Framework)** ### 步骤 1. 下载最新的发布版本。 2. 将 `SPF_MapOrigin` 文件夹复制到 `\bin\win_x64\plugins\spfPlugins\` 中。 ## 如何使用 1. 启动游戏并驾驶到任意位置。 2. 按 **`Ctrl + F11`** 触发 Origin 报告。 3. **检查日志**：打开 `Documents\American Truck Simulator\game.log.txt`（或游戏内控制台）查看详细报告，包括当前生效的归属文件和接缝检测器的结果。

🙏 致谢

本项目使用 **[SPF-Framework](https://github.com/TrackAndTruckDevs/SPF-Framework)** 创建，该框架是 ATS/ETS2 现代插件开发的基础。

标签：ATS, Bash脚本, ETS2, 云资产清单, 安全意识培训, 客户端加密, 游戏插件, 游戏模组, 诊断工具, 逆向工程