Note: Map Enhancer is an original Railroader mod by Vanguard. Version 1.5.6 includes community fixes and improvements contributed to this repository.
Map Enhancer adds map controls, overlays, track visualization, train information, and tools for managing your railroad. The latest stable release is v1.5.6.
Community contributions are welcome and are maintained together with the original project.
- Download the latest release from the Releases page
- Install the mod in Unity Mod Manager
- Launch Railroader and configure your preferred settings
-
๐ ๏ธ Added: Enable Debug Logging setting
- Added a dedicated toggle to enable verbose diagnostic logging only when needed.
- Keeps
Player.logclean during normal gameplay while allowing detailed troubleshooting when debugging. - Verbose consist refresh and turntable synchronization logs are now only written when Debug Logging is enabled.
-
๐ Improved: Logging
- Reduced repetitive consist refresh log spam by deduplicating identical entries.
- Moved routine turntable status messages to debug-only logging.
- Important warnings and errors continue to be logged regardless of the debug setting.
-
๐บ๏ธ Added: Advanced Map Window Controls toggle
- Added a new setting to show or hide optional controls in the in-game map window.
- When enabled, the map displays:
- Switch Reset
- Hover Grade
- Grade Markers
- Grade Color Overlay
- When disabled, only the essential Location and Locomotive controls remain for a cleaner interface.
-
๐จ Improved: Map Window
- The map window now preserves its current size when advanced controls are shown or hidden.
- Eliminated unwanted resizing caused by toggling map controls, resulting in a smoother user experience.
- ๐ง Added: Live train details on hover (driver, speed, weight, cars, consist length)
- ๐ Added: Locomotive fuel level details showing diesel, water, and coal percentages
- ๐ฆ Added: Dynamic consist cargo summary (cargo types and weights) and destinations aggregated directly in the main train tooltip
- ๐ Added: Individual freight car tooltips on hover (car identifier, type, cargo load, and destination)
- ๐ฅ Added: Journal oil health percentage and hand brake status
โ ๏ธ Added: Predictive Alerts system for hotbox prevention (Hotbox Detected, Hotbox Risk <10%, Critical Oil <25%, Low Oil <50%, and Hand Brake Applied)- ๐จ Added: Dynamic track colors inside the grade hover tooltip, matching settings-defined colors
- ๐ Fixed: Caching issues for engine-less consists on sidings so loose cars display hover details correctly
- ๐ Added: Hover grade details for track segments, including grade percentage and uphill/downhill direction
- ๐ท๏ธ Added: Optional grade text markers in the map window for segments above the configured intensity threshold
- ๐จ Added: Grade color overlay with configurable grade-band colors
- ๐งญ Added: Marker placement offset beside the track for improved readability
- ๐ฃ๏ธ Added: Road crossing markers on the map (uses
level-crossing.png) - ๐งญ Added: Clustering for nearby crossing points to avoid duplicate icons at multi-track crossings
- โ๏ธ Added:
Show Road Crossing Markerstoggle in settings - ๐ Added:
CrossingMarkerScaleslider (default: 0.3)
- ๐ Added:
Check Turntable Clearance/Fouling Before Rotationtoggle - โ Default: Enabled, but can be disabled if the automatic fouling check is too strict
- ๐ฏ Smooth rotation of the turntable using the Map controls
- ๐ Multiplayer sync for host and client
- ๐ When the table fouled, the rotation is blocked
- ๐ Enhanced Switch Reset Logging
- ๐ฎ Three rotation modes: Ctrl+Click (clockwise), Alt+Click (counterclockwise), Shift+Click (180ยฐ)
- ๐ฏ Control turntables directly from the map with visual markers
- ๐ฎ Three rotation modes: Ctrl+Click (clockwise), Alt+Click (counterclockwise), Shift+Click (180ยฐ)
- โ๏ธ Toggle visibility in settings (controls still work without markers visible)
- ๐ Consistent marker sizing at all zoom levels
- ๐ฏ Auto-detects valid connected tracks only
- ๐ Large clickable area for easy interaction
- ๐บ๏ธ Load custom teleport locations from mods via
spawn-points.jsonfiles - ๐ Whitelist system for approved mods
- ๐ฏ Modded locations appear under "---- Other ----" separator
- ๐ Toggle control: "Additional Locations from Mods" setting (disabled by default)
- ๐ฅ AR Branch template included with 9 spawn points
- ๐จ Fixed freight car icon colors for modded map areas (AR Branch, etc.)
- ๐ ๏ธ Robust parsing handles scientific notation and locale differences
- ๐ง Fixed: AR Branchline mod compatibility issues
- ๐ง Fixed: Mod conflict with Zamu.ForYourConvenience (FYC)
- โ Fixed: Junction switches not showing on map when both mods are active
- โ Fixed: Map UI settings menu not appearing with AR Branch and FYC
- ๐ก๏ธ Improved: Map extension initialization to prevent conflicts with other map mods
- ๐ Logs switch reset actions with player name tracking (Steam display name)
- ๐ Anti-trolling: See who reset switches in multiplayer sessions
- โฐ Triple logging: in-game console,
railloader.log, and a dedicated per-mod log file- Dedicated file:
Mods/MapEnhancer/MapEnhancer_SwitchResets.log(created automatically when the first reset is performed)
- Dedicated file:
- ๐จ Full control over unreachable/unavailable track color when industry area colors enabled
- ๐๏ธ Consistent RGBA slider UI for all color pickers
- ๐ง Fixed interchange tracks appearing dark gray with LegoTrainMan's Cross Traffic mod
- ๐จ Interchanges now correctly display yellow or proper area colors
- ๐ก๏ธ Skips Cross Traffic's global industry area to prevent color conflicts
- โ Full compatibility with Cross Traffic functionality maintained
- ๐จ Industrial tracks colored by their owning area's color (instead of uniform yellow)
- ๐ง Toggle control in mod settings (enabled by default)
- ๐ฏ Area registry lookup for accurate industry ownership detection
- โ Works correctly with both vanilla and modded industries
- ๐ Light grey color for unreachable tracks (prevents confusion with red Sylva area)
- ๐ Position-based fallback if registry lookup fails
- ๐ก๏ธ Inactive industry guard prevents disabled industries from affecting track colors
- ๐ฆ Real-time signal aspect visualization on map
- ๐ด Red: Stop
- ๐ก Yellow: Approach/Diverging Approach
- ๐ข Green: Clear/Diverging Clear
- ๐ Orange: Restricting
- ๐๏ธ Track colors are purely visual - doesn't modify underlying track classes
- ๐ Prevents conflicts with other mods that depend on track classifications
- โ๏ธ Toggle feature in settings (enabled by default)
- ๐ Compatible with all existing MapEnhancer features
- ๐ฃ Highlight passenger stop track segments in purple
- ๐ง Toggle feature in settings (disabled by default)
- ๐จ Custom color picker for passenger stops
- ๐ Reset ALL switches to Normal position (straight/mainline route)
- ๐ Reset ALL switches to Thrown position (diverging route)
- ๐ Accessible via dropdown in map settings panel
- โก Quick bulk operations for track management
- ๐ Logged actions with player identification (v1.5.4.1)
- โ Fixed race condition with track classification
- โ Resolved mainline/industrial tracks incorrectly classified as branch
- โ Track segments now properly classified after all mods initialize
- โ Industrial track coloring preserved correctly
- โ Improved compatibility with other map/track mods
- ๐ฏ Customizable junction markers with size controls
- ๐ Visual indicators for switch positions (green=normal, red=thrown)
- ๐๏ธ Adjustable marker scale (0.5 - 1.0)
- ๐๏ธ Auto-hide non-mainline markers at zoom threshold
- ๐จ Fully customizable track colors (mainline, branch, industrial, unavailable)
- ๐ Adjustable track line thickness (0.5 - 2.0)
- ๐ RGBA color pickers for all track types
- ๐ฏ Track class-based automatic coloring
- ๐ See ALL cars on the map, not just locomotives
- ๐ Car identification labels (reporting mark + road number)
- ๐จ Freight car color coding by destination area
- ๐ฆ Visual representation scaled by car length
- ๐ Click to inspect car details
- ๐ฅ Visual flare indicators on the map
- ๐ Place flares directly from map view
- ๐๏ธ Adjustable flare marker scale (0.1 - 1.0)
- ๐๏ธ Click flares to remove them
- ๐ Customizable min/max zoom levels (50 - 15000 range)
- ๐ Map window resizing (200 - 800 docked size)
- ๐ฎ Anti-aliasing options (Off, 2x, 4x, 8x)
- ๐ฏ Better zoom normalization and icon scaling
- ๐ Quick teleport dropdown to major locations
- ๐จ Color-coded locations by area
- ๐บ๏ธ Auto-sorted by area color (hue-based)
- โก Instant camera repositioning
- ๐ Dropdown list of all locomotives
- ๐ Sorted by locomotive name
- ๐ Click to center map on selected locomotive
- ๐ Auto-updates as locomotives are added/removed
Z- Toggle map size (docked/fullscreen)Ctrl+Z- Toggle follow mode (keeps map focused on selected locomotive)Shift+Z- Re-center map on current camera positionLeft Click- Place flare (when flare tool is active)Double Click- Optional: Require double-click for interactions
- ๐ฑ๏ธ Drag to pan the map
- ๐ Scroll to zoom in/out
- ๐ Click icons to interact (inspect cars, remove flares, etc.)
- ๐ฏ Click locomotives/cars to inspect and select
- ๐ข Mainline Tracks: Green (RGB [0, 155, 0], customisable)
- ๐ต Branch/Yard Tracks: Blue (Teal, customisable)
- ๐ก Industrial Tracks: Yellow (or area color when enabled)
- โช Unavailable Tracks: Red (or light grey when industry area colors enabled, customisable)
- ๐ฃ Passenger Stops: Purple (when tracking enabled, customisable)
- ๐จ Full RGBA color pickers for all track types
- ๐พ Colors persist between sessions
- ๐ Reset to defaults available
Map Enhancer includes the original features below along with the community improvements listed above:
- ๐ง Train & Cargo Intelligence - Aggregated consist stats, fuel tracker, and freight/destination summary (v1.5.5)
- ๐ Individual Car Tooltips - Car identifiers, waybill delivery status, cargo loads, journal oil health tracker and predictive alerts (v1.5.5)
- ๐จ Dynamic tooltip track colors - Matches segment/industry colors inside hover grade tooltip (v1.5.5)
- ๐ Grade indicators - Hover details, map markers, and overlay coloring for track grades (v1.5.4.5)
- ๐ Turntable clearance toggle - Optionally bypass fouling checks when manual rotation should still work (v1.5.4.4)
- ๐บ๏ธ Modded spawn points support - Load custom teleport locations from mods (v1.5.4.2)
- ๐จ Fixed car icon colors - Freight car delivery status works on modded maps (v1.5.4.2)
- ๐ฏ Turntable control from map - Control turntables with Ctrl/Alt/Shift+Click (v1.5.4.2)
- ๐ง AR Branch & FYC compatibility - Fixed switches and map UI issues (v1.5.4.1)
- ๐ Switch reset logging - Track who resets switches in multiplayer (v1.5.4.1)
- ๐จ Customizable unreachable track color - Full control over unavailable track appearance (v1.5.4.1)
- ๐ง Cross Traffic mod compatibility - No more gray interchanges (v1.5.4)
- ๐จ Industry area colors - Tracks colored by owning area (v1.5.3.7)
- ๐ฆ Signal status display - Real-time signal aspects on map (v1.5.3.6)
- ๐ฃ Passenger stop tracking - Optional purple highlighting (v1.5.3.6)
- ๐๏ธ Visual-only track colors - No conflicts with other mods (v1.5.3.6)
- ๐ Bulk switch reset tools - Reset all switches at once (v1.5.3.6)
- โ Critical bug fixes - Track classification race conditions resolved (v1.5.2)
See detailed feature descriptions below and full changelog in Version History.
All settings are available and shown when game first launches.
- Fusee (Flare) Marker Scale: 0.1 - 1.0 (default: 0.6)
- Junction Marker Scale: 0.5 - 1.0 (default: 0.6)
- Junction Non-Mainline Marker Cutoff: 0.01 - 1.0 (default: 0.12)
- Controls when non-mainline junction markers hide based on zoom level
- Track Line Thickness: 0.5 - 2.0 (default: 1.25)
- Map Window Antialiasing: Off, 2x, 4x, 8x (default: 4x)
- Docked Map Window Size: 200 - 800 (default: 800)
- Map Zoom Min: 50 - 100 (default: 50)
- Lower values = more zoom in capability
- Map Zoom Max: 5000 - 15000 (default: 10000)
- Higher values = more zoom out capability
- Require Double Click: Toggle for double-click requirement on map interactions
- Show Turntable Markers: Toggle visibility of turntable markers (default: ON)
- Check Turntable Clearance/Fouling Before Rotation: Block turntable rotation when fouled (default: ON)
- Toggle Map Size: Default
Z(customizable) - Follow Mode: Default
Ctrl+Z(customizable) - Re-center Map: Default
Shift+Z(customizable)
Customize colors for all track types with RGBA sliders:
- Mainline Track Color
- Branch/Yard Track Color
- Industry Track Color
- Unavailable Track Color
- Passenger Stop Track Color (when enabled)
- Unreachable Track Color (when industry area colors enabled)
- โ๏ธ Use Visual-Only Track Coloring (default: ON)
- โ Enable Passenger Stop Tracking (default: OFF)
- โ๏ธ Enable Industry Area Colors (default: ON)
- โ๏ธ Show Train Hover Details: Toggle showing the detailed info panel on hover (default: ON)
- โ๏ธ Show Driver Name (default: ON)
- โ๏ธ Show Train Stats: speed, weight, cars, length (default: ON)
- โ๏ธ Show Locomotive Fuel Levels (default: ON)
- โ๏ธ Show Cargo Summary: cargo weight and types (default: ON)
- โ๏ธ Show Destination Summary: target destinations (default: ON)
- โ๏ธ Show Individual Freight Car Tooltip on Hover (default: ON)
- Compatibility may vary with other mods that modify the map or track classification.
All feedback, bug reports, and feature requests are welcomed!
- Discord Forum: Map Enhancer Discussion
- Railroader Official Discord: Join Discord
- RTM Discord: Join Discord
- Issues: Report bugs in the issue tracker
Contributions are welcome. Please open an issue or pull request with details about the proposed change.
-
โจ Fix debug logging spam in player.log
- Added a toggle in settings to enable debug logs
-
๐ Improved: Logging
- Reduced repetitive consist refresh log spam by deduplicating identical entries.
- Moved routine turntable status messages to debug-only logging.
-
๐บ๏ธ Added: Advanced Map Window Controls toggle
- Added a new setting to show or hide optional controls in the in-game map window.
-
๐จ Improved: Map Window
- The map window now preserves its current size when advanced controls are shown or hidden.
- ๐ง Added: Train & Cargo Intelligence Layer
- Live train info panel on hover with driver name, speed, total tonnage, car count, and consist length.
- Aggregated fuel levels (diesel/water/coal percentage) for locomotives in consist.
- Consolidated consist cargo list (cargo types and weights) and destinations.
- ๐ Added: Individual Freight Car Tooltips
- Hovering a freight car marker shows car identification, type, waybill status, cargo, and capacity details.
- Detailed journal oil level tracking (using
OiledAPI) and hand brake status. - Prioritized alerts list for predictive maintenance:
- ๐ Hotbox Detected (active hotbox failure)
โ ๏ธ Hotbox Risk (under 10% oil)โ ๏ธ Critical Journal Oil (under 25% oil)โ ๏ธ Low Journal Oil (under 50% oil)โ ๏ธ Hand Brake Applied
- ๐จ Improved: Dynamic Grade Tooltip Styling
- The grade hover tooltip now displays track type and name styled in the actual color assigned to that track type/industry area.
- ๐ Fixed: Loose car caching so details for uncoupled cars on sidings update and display correctly.
- ๐ Added: Hover grade details for track segments with grade percentage and direction
- ๐ท๏ธ Added: Optional grade markers in the map window for segments above the configured intensity threshold
- ๐จ Added: Grade color overlay with configurable colors for flat, gentle, moderate, and steep grades
- ๐งญ Improved: Grade markers are offset beside the track for easier reading
- ๐จ Improved: Grade marker text now uses the same grade-band color palette as the overlay
- ๐ฃ๏ธ Added: Road crossing markers on the map (uses
level-crossing.png) - ๐งญ Added: Clustering for nearby crossing points to avoid duplicate icons at multi-track crossings
- โ๏ธ Added:
Show Road Crossing Markerstoggle in settings - ๐ Added:
CrossingMarkerScaleslider (default: 0.3) to control icon size - ๐ Added:
Check Turntable Clearance/Fouling Before Rotationtoggle (default: ON) - ๐งฐ Fixed: Hardened PNG loader and prefab cleanup to prevent fallback placeholder icons
- ๐ฆ Changed: Packaging updated to include only
level-crossing.pngfor crossing icons
- ๐ Major: Improved multiplayer synchronization for turntable rotation
- Host-authoritative, property-change-based replication for reliable turntable control
- Peers observe and apply turntable rotation requests deterministically (reduces missed/queued clicks)
- Removed fragile sequence gating and timeout-dependent completion waits
- ๐ Added: Improved switch-reset audit handling and host-side logging (console + MapEnhancer_SwitchResets.log)
- ๐ง Fix: Turntable marker visibility and prefab tweaks (brown center circle now shows reliably)
- ๐จ Fix: Restored freight car destination color logic for modded areas
- ๐ ๏ธ Misc: Various multiplayer robustness and logging improvements
- ๐ฏ Added: Turntable control from map with Ctrl/Alt/Shift+Click rotation modes
- ๐จ Added: Turntable visual markers with customizable color and opacity
- ๐บ๏ธ Added: Modded spawn points loading system with JSON format support
- ๐ Added:
EnableModdedSpawnPointssetting with whitelist system - ๐ฏ Added: "---- Other ----" separator in teleport dropdown for modded locations
- ๐ฅ Added: AR Branch spawn-points.json template with 9 locations
- ๐จ Fixed: Car icon color darkening for modded areas with bright colors (hybrid HSV system)
- ๐ ๏ธ Fixed: Spawn point parsing to handle scientific notation and locale differences
- โ Fixed: Graceful error handling for malformed spawn-points.json entries
- ๐ Improved: Culture-independent parsing with detailed error messages
- ๐ง Fixed: AR Branchline mod compatibility issues
- ๐ง Fixed: Mod conflict with Zamu.ForYourConvenience (FYC)
- โ Fixed: Junction switches not showing on map when both mods are active
- โ Fixed: Map UI settings menu not appearing with AR Branch and FYC
- ๐ก๏ธ Improved: Map extension initialization to prevent conflicts with other map mods
- ๐ Added: Switch reset logging with player name tracking
- Logging: in-game console, railloader.log
- Timestamped file logs with total switch count
- Anti-trolling feature for multiplayer sessions
- ๐จ Added: Customizable unreachable track color setting
- RGBA color picker for unreachable tracks when industry area colors enabled
- Replaces hardcoded light grey color with user preference
- Separate from standard unavailable track color
- ๐๏ธ Fixed: Passenger Stop and Unreachable Track color pickers now use consistent slider UI
- ๐ง Improved: Better visual customization options for all track color scenarios
- ๐ง Fixed: Interchange tracks appearing dark gray with LegoTrainMan's Cross Traffic mod
- ๐ก๏ธ Added: Check to skip Cross Traffic's "legos-global-industries" area identifier
- ๐ก๏ธ Added: Guard for inactive industry components
- โ Maintains full compatibility with Cross Traffic functionality
- โจ Added: Industrial tracks colored by owning area's color (toggle in settings)
- ๐ฏ Added: Area registry lookup for accurate industry ownership detection
- ๐จ Changed: Unreachable tracks now light grey (prevents confusion with red Sylva area)
- โ Fixed: Modded industries showing incorrect colors
- โจ Added: Position-based fallback detection
- ๐ฆ Added: Signal status display on map with color-coded aspects
- ๐ฃ Added: Passenger stop tracking with toggle (purple highlighting)
- ๐๏ธ Added: Visual-only track coloring mode to prevent mod conflicts
- ๐ Added: Bulk switch reset tools (All Normal / All Thrown)
- ๐ Fixed: Track classification issues and branch/passenger track detection
- ๐ Fixed: Race condition with track classification
- โ Fixed: Mainline/industrial tracks misclassified as branch
- ๐ Improved: Compatibility with other map/track mods
See Releases for complete version history.
- Original Author: Vanguard - Original Nexus Mods Page
- Community Contributor: Reaper8f
- Contributors: Thanks to all community members who contributed fixes, testing, and documentation.
This project maintains the same license as the original Map Enhancer mod.
๐ฎ Happy Railroading!
Community improvements are included in the main repository with the original author's project history and credits preserved.


