Documentation
Installation
Install MTR Surveyor on a Minecraft Forge 1.20.1 client.
MTR Surveyor is a client-side Forge mod. You only need it on your own Minecraft client — it works on any server, including ones that don’t have the mod installed.
Prerequisites
| Mod | Version | Required? |
|---|---|---|
| Minecraft Forge | 1.20.1 (47.x) | Required |
| Minecraft Transit Railway (MTR) | ≥ 4.0.2-hotfix-1 | Required |
| Xaero’s Minimap | ≥ 25.3.10 | Recommended |
| Xaero’s World Map | ≥ 1.40.11 | Recommended |
| Java | 17 or newer | Required |
Heads up: MTR is mandatory — without it there’s nothing to map. Xaero’s mods are technically optional, but you need at least Xaero’s Minimap for waypoint sync, and Xaero’s World Map for the route-line overlay. If a Xaero mod is missing, MTR Surveyor loads safely and simply skips the features that need it.
Step 1 — Install Forge 1.20.1
Install Minecraft Forge for 1.20.1 (47.2.0 or newer). Launch the Forge profile once to generate the .minecraft/mods/ folder.
Step 2 — Add the dependencies
Drop the following jars into .minecraft/mods/:
- MTR — from Modrinth or CurseForge. Use the Forge 1.20.1 build, version
4.0.2-hotfix-1or newer. - Xaero’s Minimap — Modrinth, build
25.3.10or newer for 1.20.1. - Xaero’s World Map — Modrinth, build
1.40.11or newer for 1.20.1.
Step 3 — Add MTR Surveyor
Download the latest CRTools-MTR-Xaero-Mapper-<version>.jar from the GitHub releases and drop it into .minecraft/mods/.
Step 4 — Launch and verify
- Launch Minecraft with the Forge profile.
- Check the game log — you should see the MTR Surveyor load line, plus a note on whether Xaero’s Minimap was detected.
- Join any server (single-player works too) that has an MTR network.
- Open Xaero’s World Map (default
Y) — you should see[MTR] ...waypoints appear within a few seconds, and anMTRtoggle widget at the top-left of the map.
If nothing shows up, see Troubleshooting.
Verifying the install
Run this client command:
/mtrsurveyor mode
It should reply with the current waypoint mode. If it errors with “Unknown command”, the mod isn’t loaded — recheck the mods folder and Forge version.
Updating
To update, just replace the old CRTools-MTR-Xaero-Mapper-*.jar with the new one. Your existing config at .minecraft/config/mtrsurveyor.toml is preserved. New config keys (if any) are added with their defaults on the next launch.