Documentation
Live trains
Track moving MTR trains across your entire dimension in real time.
Starting in version 1.5.2, MTR Map Overlay lets you watch trains move across your map in real time. You don’t have to be standing near a track to see them — as long as the server has MTR Map Overlay installed, you can track trains operating across the entire dimension.
How it works
The server gets authoritative train positions from MTR/TSC and streams lightweight position updates to clients at roughly 4 Hz. Your client smoothly interpolates between these updates to draw fluid train movement on the map. Because syncing happens across the whole dimension, panning or zooming across the map won’t interrupt train tracking.
If MTR Map Overlay is only installed on your client, you’ll only see trains that happen to be in your player’s local chunk loading radius.
Zoom levels and train details
The train visuals automatically adapt to your zoom level:
- Zoomed out: Trains appear as compact direction chevrons showing which way they’re heading.
- Zoomed in: Trains render as 2D carriages with route-colored side panels and consist outlines.
Hover your cursor over any train to view its details:
- Train model name
- Assigned route and destination
- Consist length (number of cars)
If certain metadata isn’t set in MTR, those fields are simply omitted.
Controls and options
Live trains are enabled by default. You can toggle them anytime using:
/mtrmap config trainCars false # Hide trains
/mtrmap config trainCars true # Show trains
In singleplayer, opening Xaero’s World Map keeps the game simulation running in the background so TSC trains continue moving while you view the map.
[!NOTE] Live train hover tooltips show route and consist details, but they don’t calculate real-time ETAs for individual stops. For live arrival countdowns and platform schedules, use the Station arrivals & PIDS feature introduced in 1.5.3.