Documentation
Configuration
How to configure MTR Map Overlay settings and config files.
You can adjust most settings directly in-game using /mtrmap config ... commands. If you prefer editing files directly, your configuration file location depends on your mod loader:
- Forge / NeoForge:
.minecraft/config/mtrmap.toml - Fabric:
.minecraft/config/mtrmap.properties
If you are upgrading from older versions on Forge or NeoForge, the mod will automatically migrate any existing mtrsurveyor.toml settings over to mtrmap.toml if it doesn’t already exist.
[!TIP] Always close Minecraft before manually editing config files so the game doesn’t overwrite your changes on exit.
Available settings
| Setting (Config File Key) | In-Game Command | Default | What it does |
|---|---|---|---|
enabled | /mtrmap config enabled <bool> | true | Master switch to turn the overlay on or off. |
showStations | /mtrmap config showStations <bool> | true | Show or hide station icons on the map. |
showPlatforms | /mtrmap config showPlatforms <bool> | true | Show or hide individual platform icons. |
showDepots | /mtrmap config showDepots <bool> | true | Show or hide depot icons. |
routeLinesEnabled | /mtrmap config routeLines <bool> | true | Show or hide colored route ribbons. |
trackLinesEnabled | /mtrmap config trackLines <bool> | true | Show or hide physical railway tracks. |
trainCarsEnabled | /mtrmap config trainCars <bool> | true | Show or hide live moving trains. |
pidsStyle | /mtrmap config pidsStyle <style> | british | Station board theme: british or european. |
networkSync.enabled | — | true | Enables downloading full-network snapshots from servers. |
networkSync.refreshIntervalSeconds | — | 300 | How often (in seconds) the client requests updated network snapshots. |
Setting names in config files
Note that while in-game commands use shortened names like routeLines, trackLines, and trainCars, the actual keys inside your config file are:
routeLinesEnabledtrackLinesEnabledtrainCarsEnabled
In Forge/NeoForge TOML files, these options sit under the [general] section. In Fabric, they are standard key-value pairs. Using the /mtrmap config in-game commands takes care of this automatically, regardless of loader.