MTR MAP OVERLAY Minecraft Transit, on your map
GitHub

Documentation

Installation

How to install MTR Map Overlay for Minecraft 1.20.1, 1.20.4, or 1.21.1.

MTR Map Overlay brings your MTR transit network to life on Xaero’s World Map and JourneyMap. You get physical tracks, route-colored lines, live train tracking, station arrival boards, and clickable station/depot icons directly on your map.

We support Minecraft 1.21.1 (NeoForge and Fabric) and 1.20.1 / 1.20.4 (Forge and Fabric). Grab the JAR that matches your exact Minecraft version and mod loader.

Requirements

MinecraftLoaderJavaMTR
1.21.1NeoForge 21.1.x or Fabric + Fabric API214.1.0-beta.2
1.20.1Forge 47.x or Fabric + Fabric API17+>=4.0.5, <4.1
1.20.4Forge 49.x or Fabric + Fabric API17+>=4.0.5, <4.1

You’ll also need either Xaero’s World Map or JourneyMap installed for the same game version:

  • JourneyMap: version 6.0.8+ (MC 1.21.1), 6.0.6+ (MC 1.20.1), or 5.10.0 (MC 1.20.4).
  • Xaero’s World Map: 1.45.0+.
  • Xaero’s Minimap is optional — you only need it if you want to clean up legacy [MTR] waypoints from older versions.

Installation steps

  1. Download the JAR matching your setup from GitHub Releases v1.6.0, the latest stable release. Filenames clearly indicate the MC version, loader, and supported MTR build.
  2. Drop the JAR into your client’s mods folder. (If you’re on Fabric, make sure you have Fabric API too).
  3. Make sure MTR and your chosen map mod are in mods.
  4. Launch Minecraft and open your fullscreen map!

Client-only vs. Server installation

You can run MTR Map Overlay purely as a client-side mod. In client-only mode, the map displays whatever MTR routes and tracks are loaded around your player.

For the best experience, install MTR Map Overlay on both the client and server:

  • Full-network visibility: See the entire transit system across all dimensions, not just what’s loaded near you.
  • Live train positions: Track trains running across the entire dimension in real time.
  • Station arrival boards: Get live arrival times and PIDS predictions right on the map.

Make sure your client and server run matching versions (e.g., 1.6.0 on both). Servers only need MTR and MTR Map Overlay — you don’t need any map mods installed on the server.

Check out the Quick start guide to learn the in-game controls, see Station arrivals & PIDS for the arrival boards, or review Compatibility for detailed version matrices.