Troubleshooting and FAQ · MTR Map Overlay

I can only see tracks right around my player

You’re running in client-only mode. When MTR Map Overlay is only installed on your client, it can only show the tracks and stations that MTR has loaded in your player’s immediate area.

To see the full transit network across the entire dimension, install MTR Map Overlay on the server as well. Once installed on both sides, you can run /mtrmap syncRoutes to pull down the full network snapshot immediately.

No tracks or routes show up at all

Check the following:

Version matching: Make sure your MTR Map Overlay JAR, MTR, and map mod versions all match your Minecraft version and loader. MC 1.20.1 and 1.20.4 need MTR 4.0.5 on Forge or Fabric. MC 1.21.1 needs MTR 4.1.0-beta.2 on NeoForge or Fabric.
Open the fullscreen map: Tracks and icons only render on the fullscreen map (Xaero’s World Map or JourneyMap), not on minimaps or the HUD.
Check your layer toggles: Make sure the TRACKS and ROUTES buttons on your map are enabled (green), or run /mtrmap config trackLines true and /mtrmap config routeLines true.
Check game logs: If Xaero’s World Map updated recently, there might be a renderer mismatch. Look in your latest.log for any errors referencing MTR Map Overlay.

Why don’t station icons show up on my minimap or waypoint list?

That’s intentional! MTR Map Overlay renders stations and platforms directly onto the fullscreen map canvas rather than creating standard waypoint markers. This keeps your waypoint list, minimap, compass bar, and in-world HUD clean and free of clutter.

The `/mtrmap` command isn’t recognized

You probably have an older version of the mod installed or the wrong JAR for your mod loader. Make sure you’re running v1.6.0 and that the JAR filename matches your Minecraft version and loader.

Do I need to install this on the server?

For basic use (client-only): No. You can join any MTR server and view tracks and stations loaded around your character.
For the full experience: Yes. You need the mod on the server if you want whole-network snapshots, dimension-wide live train tracking, and live station arrival boards.

Which Minecraft versions and mod loaders work?

Minecraft 1.21.1: NeoForge or Fabric.
Minecraft 1.20.1: Forge or Fabric.
Minecraft 1.20.4: Forge or Fabric.

See the compatibility matrix for exact MTR, Java, and map mod version requirements.

Why does the station arrival board show dashes instead of times?

Live arrival boards require matching 1.6.0 versions on both your client and the server.

When you expand a station card, the board reads real-time predictions directly from MTR/TSC’s native PIDS system. If no trains are currently scheduled or en route to that platform, it shows a dash (-) rather than a misleading arrival time.

Why is the Navigate button disabled?

The Navigate button is reserved for third-party navigation and route-planning mods. MTR Map Overlay provides the map visualizer and the API, but doesn’t include a built-in pathfinding engine. In 1.6.0, a registered provider must also be able to handle the selected station. If none can, Navigate stays dimmed; only available providers appear in the chooser.

Live trains only appear when I’m standing near the tracks

Make sure live trains are enabled (/mtrmap config trainCars true) and that the server has MTR Map Overlay installed. Dimension-wide train tracking requires the server-side mod to broadcast active train positions. See Live trains for more information.