SPF Map Origin & Seam Detector Plugin

---

A specialized diagnostic plugin for American Truck Simulator and Euro Truck Simulator 2 that identifies the source (Mod or DLC) of the current map sector. It features an advanced Map Seam Detector to visualize transitions between different map mods.

🎓 Demonstration Purpose

This project demonstrates advanced reverse engineering techniques for the game's Virtual File System (VFS):

• VFS Pool Iteration: Scanning Mod, SCS, and Base pools to resolve file priority.
• Reverse Priority Identification: Implementing "Winner-takes-all" logic to find the active sector override.
• Dynamic Sector Mapping: Real-time calculation of map coordinates into the game's 5120x5120 sector grid.
• Pattern-based Memory Discovery: Finding VFS sentinels and map path pointers without hardcoded addresses.

Features

• Sector Winner Identification: Instantly reveals which mod or DLC "owns" the sector you are currently in.
• Full Archive Stack: Lists every single archive (SCS or Mod) that contains the current sector file.
• 4-Way Seam Detector: Scans North, South, East, and West neighbors to find transitions between mods.
• Visual Status Indicators:
  • [SAME]: Neighbor belongs to the same mod.
  • [BASE]: Neighbor is part of the original game or official DLC.
  • [SEAM]: Neighbor belongs to a different mod (Seam detected!).
  • [VOID]: Neighboring sector is empty (Edge of the map).
• Universal Map Support: Automatically detects map names (usa, europe, promods, etc.) directly from memory.

Support the Project

If you find this tool useful for map development or mod troubleshooting, consider supporting us on Patreon.

► Support on Patreon

How to Build 🛠️

This is a standard CMake project. To build it from source:

1. Clone this repository.
2. Ensure you have CMake and Visual Studio (MSVC) installed.
3. Create a build directory.
4. Run cmake .. and then cmake --build ..

Installation

Prerequisites

You must have the SPF Framework installed.

• Download the SPF-Framework here

Steps

1. Download the latest release.
2. Copy the SPF_MapOrigin folder into \bin\win_x64\plugins\spfPlugins\.

How to Use

1. Start the game and drive to any location.
2. Press Ctrl + F11 to trigger the Origin Report.
3. Check the Log: Open Documents\American Truck Simulator\game.log.txt (or the in-game console) to see the detailed report, including the active winner and the seam detector results.

🙏 Acknowledgements

This project was created using the SPF-Framework, the foundation for modern plugin development in ATS/ETS2.