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 CommandDefaultWhat it does
enabled/mtrmap config enabled <bool>trueMaster switch to turn the overlay on or off.
showStations/mtrmap config showStations <bool>trueShow or hide station icons on the map.
showPlatforms/mtrmap config showPlatforms <bool>trueShow or hide individual platform icons.
showDepots/mtrmap config showDepots <bool>trueShow or hide depot icons.
routeLinesEnabled/mtrmap config routeLines <bool>trueShow or hide colored route ribbons.
trackLinesEnabled/mtrmap config trackLines <bool>trueShow or hide physical railway tracks.
trainCarsEnabled/mtrmap config trainCars <bool>trueShow or hide live moving trains.
pidsStyle/mtrmap config pidsStyle <style>britishStation board theme: british or european.
networkSync.enabled—trueEnables downloading full-network snapshots from servers.
networkSync.refreshIntervalSeconds—300How 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:

  • routeLinesEnabled
  • trackLinesEnabled
  • trainCarsEnabled

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.