Documentation
Quick start
Get up and running with MTR Map Overlay in a few minutes.
Open your map
Hop into a world with MTR tracks and stations, then press your map key to open Xaero’s World Map or JourneyMap. You’ll immediately see physical rails, colorful route ribbons, and station/platform/depot icons overlaid directly on the terrain.
Toggle layers
Both map mods include dedicated buttons to toggle layers independently:
- TRACKS: Toggles the physical rail lines.
- ROUTES: Toggles the colored route lines running along those rails.
Green means the layer is visible, red means it’s hidden. In JourneyMap, these buttons sit right in the add-on toolbar. You can also toggle them with commands:
/mtrmap config trackLines <true|false>/mtrmap config routeLines <true|false>
Hover your cursor over any route or station icon to see its name and lines. When multiple routes share the same physical track, they render side-by-side as distinct colored stripes so you can see every line clearly.
Nearby vs. Whole-network data
If MTR Map Overlay is only installed on your client, it displays whatever MTR data the server sends to you locally (usually the area right around your player).
If the server also has MTR Map Overlay installed, your client gets a complete network snapshot for your dimension. You can manually refresh this snapshot anytime with:
/mtrmap syncRoutes
Check out Display modes, Commands, and JourneyMap integration to learn more.
Live trains and station boards
When playing on a server with MTR Map Overlay installed:
- Live trains: Watch trains move across the map in real time. Hover over any train to see its route, destination, model, and car count. If you ever want to hide trains, run
/mtrmap config trainCars false. See Live trains for details. - Station boards (1.5.3+): Click any station icon to pin its info card. Click Expand to bring up a live arrival board showing upcoming trains, platforms, and countdown timers straight from MTR. By default, it uses a British PIDS theme (amber text on black), but you can switch to European airport style anytime using
/mtrmap config pidsStyle european. See Station arrivals & PIDS for more. - Navigation: The station card has a Navigate button reserved for compatible third-party routing mods. In 1.6.0, it checks which providers can handle the selected station; if none can, the button stays greyed out.
In-game language
In 1.6.0, map controls, arrival boards, tooltips and command feedback follow your Minecraft language: English, Simplified Chinese, Traditional Chinese or Japanese. Player-defined station and route names stay as you wrote them. Command names such as /mtrmap config pidsStyle stay the same.