How guywithpaper/snowrunner-minimap works
Map Runner is a Windows minimap overlay for SnowRunner. Its main workflow reads the truck’s live position, identifies the current region, builds or loads that region’s map and markers from installed game files, and presents the result in the overlay and big map. Save data supplies vehicle and completion state; settings govern display and controls. The README documents additional map layers and waypoint features. Several implementation files are represented by their exact paths, but unsampled internals are not inferred beyond documented behavior or indexed references.
Main entry points: app.py Overlay app · maprender.py Region map rendering · reader.py Truck position reader · settings.py Settings model
Components 26
Overlay runtime
- Overlay app
minimap/app.py - Big map and pins
minimap/app.py
Game world data
- Truck position reader
minimap/reader.py - Process memory access
minimap/procmem.py - RTTI lookup
minimap/rtti.py - Game waypoints
minimap/gamewp.py - Save data
minimap/savedata.py
Map and navigation
- Region detection and markers
minimap/levels.py - Region map rendering
minimap/maprender.py - Terrain rendering
minimap/terrain.py - Mesh parsing
minimap/sr_mesh.py - Tree sprites
minimap/treesprites.py - Map icons
minimap/icons.py - Game icon data
minimap/gameicons.py - Route planning
minimap/routing.py - Rendered map cache
Settings and updates
- Game and data paths
minimap/paths.py - Settings model
minimap/settings.py - Settings window
minimap/settingswin.py - Update checks
minimap/updater.py - Version metadata
minimap/version.py
Other components
- Player
- SnowRunner
- Installed game files
- Game save files
- User
Connections 29
- Player → SnowRunner: drives
README.md - SnowRunner → Truck position reader: provides live process
README.md - Truck position reader → Process memory access: reads memory
minimap/reader.py - Truck position reader → RTTI lookup: finds RTTI class
minimap/reader.py - Overlay app → Truck position reader: reads position
minimap/app.py - Overlay app → Region detection and markers: detects region
minimap/app.py - Region detection and markers → Region map rendering: uses map index
minimap/levels.py - Region map rendering → Installed game files: reads map assets
README.md - Region map rendering → Terrain rendering: renders ground
minimap/terrain.py - Region map rendering → Mesh parsing: parses meshes
minimap/sr_mesh.py - Region map rendering → Tree sprites: builds tree sprites
minimap/maprender.py - Overlay app → Region map rendering: requests map
minimap/app.py - Overlay app → Rendered map cache: loads or saves
README.md - Overlay app → Map icons: uses marker icons
minimap/app.py - Map icons → Game icon data: uses game icon data
minimap/icons.py - Overlay app → Save data: reads save state
minimap/app.py - Save data → Game save files: reads saves
minimap/savedata.py - Overlay app → Route planning: plans routes
minimap/app.py - Overlay app → Game waypoints: syncs waypoints
minimap/app.py - User → Overlay app: uses overlay
README.md - User → Big map and pins: pans and pins
README.md - Overlay app → Big map and pins: opens big map
README.md - Overlay app → Settings model: loads settings
minimap/app.py - Overlay app → Settings window: opens settings
minimap/app.py - Settings window → Settings model: edits settings
minimap/settingswin.py - Overlay app → Update checks: checks updates
minimap/app.py - Update checks → Version metadata: checks version
minimap/updater.py - Settings model → Game and data paths: locates settings
minimap/settings.py - Region map rendering → Game and data paths: locates game data
minimap/levels.py