modpacks.ch by CreeperHost No ads. Just mods.
Back to mods
MTR Map Overlay project artwork

CurseForge · Minecraft mod

MTR Map Overlay

Real-Shape MTR tracks and routes overlay on Xaero's World Map / JourneyMap

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which MTR Map Overlay release should I use?

Updated yesterday
Latest stable file CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar
Game version 1.20.1
Loader Fabric

MTR Map Overlay CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar targets 1.20.1 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

Is MTR Map Overlay required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does MTR Map Overlay CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar need?

CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Minecraft Transit Railway (Automated trains, planes, and more!) first. We found matching files for this game-version and loader setup. 6 come through another mod in the chain.

3 listed on this file 6 pulled in by those mods
JourneyMap Optional for MTR Map Overlay CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar
optional
Matching file found Matched file: journeymap-1.20.1-6.0.6+fabric
Xaero's World Map Optional for MTR Map Overlay CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar
optional
Matching file found Matched file: xaeroworldmap-fabric-1.20.1-1.46.0.jar
Fabric API Needed by Xaero's World Map
pulled in
Matching file found Matched file: [1.20.1] Fabric API 0.92.12+1.20.1
Open Parties and Claims Needed by Xaero's World Map
pulled in
Matching file found Matched file: open-parties-and-claims-fabric-1.20.1-0.31.6.jar
Xaero's Minimap Needed by Xaero's World Map
pulled in
Matching file found Matched file: xaerominimap-fabric-1.20.1-26.5.0.jar
The Tube Needed by Minecraft Transit Railway (Automated trains, planes, and more!)
pulled in
Matching file found Matched file: FABRIC-2.2.4+1.20.1
Forge Config API Port Needed by Open Parties and Claims
pulled in
Matching file found Matched file: [FABRIC] [1.20.1] ForgeConfigAPIPort-v8.0.3

6 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add MTR Map Overlay without breaking your instance.

Built for MTR Map Overlay CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar. It targets 1.20.1 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Minecraft Transit Railway (Automated trains, planes, and more!) first. We found matching files for this game-version and loader setup. 6 come through another mod in the chain.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside CRTools-MTR-Map-Overlay-1.5.1-MC1.20.1-MTR4.0.5-fabric.jar. It opens that exact file at the source.

About this project

What does MTR Map Overlay add?

English

MTR Map Overlay is a Minecraft 1.21.1 add-on for **NeoForge or Fabric**. It reads Minecraft Transit Railway (MTR) data and integrates with Xaero's World Map and JourneyMap. It does not depend on MTR Surveyor's map.

Features

Map Overlay
Xaero's World Map Physical rail geometry, route-coloured ribbons, and compact station, platform and depot icons. Hover to inspect routes and landmarks.
JourneyMap Physical rails, shared-route colour bands, and station, platform and depot icons on the fullscreen map, with separate TRACKS and ROUTES controls.

These are **map-only icons**, not ordinary Xaero waypoints: they do not fill the waypoint list, compass, minimap or in-world HUD. Multiple routes on one physical rail occupy adjacent colour bands rather than overwriting one another. Both map integrations draw physical rails first, coloured routes on top, and station/platform icons last. In JourneyMap, the entire layer follows the map's live drag and zoom transform; track width matches Xaero's screen-pixel style.

When the mod is installed on the server as well as the client, it can request a **whole-network snapshot** for each dimension. Without the server component it still works, but can show only the nearby data MTR has sent to the client. Xaero and JourneyMap are optional integrations; install either or both.

Requirements and installation

Component Requirement
Minecraft 1.21.1, Java 21
Mod loader NeoForge 21.1.x **or** Fabric Loader with Fabric API
MTR 4.1.0-beta.2, built for the same loader
Map mod Xaero's World Map 1.45.0+ and/or JourneyMap 6.0.8+ for the respective loader
Xaero's Minimap Optional; used only to remove old [MTR] waypoints created by earlier releases
  1. Download the **NeoForge** or **Fabric** JAR from Releases. Install **one**, not both, in the client's mods directory.
  2. Install MTR and your chosen map mod for that same loader. Fabric additionally needs Fabric API.
  3. Optionally install the matching MTR Map Overlay JAR and MTR on the server to enable the whole-network view. Client and server must use the mtrmap mod ID; older mtrsurveyor builds are not compatible with this release.
  4. Open Xaero's World Map or JourneyMap's fullscreen map. Both maps have matching ROUTES and TRACKS icons (green left bar = on, red = off); JourneyMap puts them in its add-on button panel. The /mtrmap config routeLines and trackLines switches apply to both maps. Hover over a line or icon for details.

The server component is not required for client-only use. NeoForge and Fabric builds and the shared headless tests are checked for this release; Fabric map rendering and cross-machine network behaviour still need in-game validation. See release notes.

Commands and configuration

Commands are registered on the **client**, so they are available even when the server does not run this mod.

Command Purpose
/mtrmap syncRoutes Request a whole-network snapshot, if the server supports it.
/mtrmap syncLandmarks Refresh JourneyMap landmarks.
/mtrmap testMarker Place a JourneyMap diagnostic marker at the player.
`/mtrmap mode station\ platform\ both` Select the client-data fallback landmark mode.
`/mtrmap config enabled <true\ false>` Enable or disable the map overlay.
`/mtrmap config showStations <true\ false>` Show or hide station icons.
`/mtrmap config showPlatforms <true\ false>` Show or hide platform icons.
`/mtrmap config showDepots <true\ false>` Show or hide depot icons.
`/mtrmap config routeLines <true\ false>` Show or hide route ribbons on both maps.
`/mtrmap config trackLines <true\ false>` Show or hide physical rails on both maps.

NeoForge stores settings in config/mtrmap.toml and copies an existing mtrsurveyor.toml on first launch when the new file is absent. Fabric uses config/mtrmap.properties with its own defaults. The two formats are not automatically interchangeable. Important options include networkSync.enabled (default true), networkSync.refreshIntervalSeconds (default 300), and the station/platform/depot visibility switches.

Build from source

Use a Java 21 toolchain. The loader builds have separate Gradle wrappers because they use different build plugins:

Loader Windows macOS / Linux Output
NeoForge .\gradlew.bat build ./gradlew build build/libs/CRTools-MTR-Map-Overlay-1.5.0.jar
Fabric .\fabric\gradlew.bat -p fabric build ./fabric/gradlew -p fabric build fabric/build/libs/CRTools-MTR-Map-Overlay-fabric-1.5.0.jar

The NeoForge build runs the shared JUnit tests. A successful build does not replace an in-game compatibility check, especially when Xaero's internal map renderer changes.

Project description from CurseForge.

Pick your setup

MTR Map Overlay by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

6 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

MTR Map Overlay versions and loaders

8 of 8 releases match

Looking for an older file? The official CurseForge project page is in Resources.

Keep browsing

See more mods

Like this one? One of these might be worth a look.