安装 · MTR Surveyor

MTR Surveyor 是一个纯客户端 Forge mod。你只需要装在自己的 Minecraft 客户端上 — 它在任何服务器上都能用，包括那些没装本 mod 的服务器。

前置要求

Mod	版本	是否必装
Minecraft Forge	1.20.1 (47.x)	必装
Minecraft Transit Railway (MTR)	≥ 4.0.2-hotfix-1	必装
Xaero’s Minimap	≥ 25.3.10	推荐
Xaero’s World Map	≥ 1.40.11	推荐
Java	17 或更高	必装

注意： MTR 是强制依赖 — 没有它就没有可映射的数据。Xaero 系列严格来说是可选的，但你至少需要 Xaero’s Minimap 才能同步路径点，需要 Xaero’s World Map 才能显示路线叠加层。如果缺失某个 Xaero mod，MTR Surveyor 会安全加载，仅跳过需要它的功能。

第 1 步 — 安装 Forge 1.20.1

安装 Minecraft Forge 1.20.1 版本（47.2.0 或更高）。启动一次 Forge 配置以生成 .minecraft/mods/ 文件夹。

第 2 步 — 加入依赖

把以下 jar 放进 .minecraft/mods/：

MTR — 来自 Modrinth 或 CurseForge。使用 Forge 1.20.1 版本，4.0.2-hotfix-1 或更高。
Xaero’s Minimap — Modrinth，1.20.1 的 25.3.10 或更高版本。
Xaero’s World Map — Modrinth，1.20.1 的 1.40.11 或更高版本。

第 3 步 — 加入 MTR Surveyor

从 GitHub Releases 下载最新的 CRTools-MTR-Xaero-Mapper-<version>.jar，放进 .minecraft/mods/。

第 4 步 — 启动并验证

用 Forge 配置启动 Minecraft。
查看游戏日志 — 应能看到 MTR Surveyor 的加载日志，以及是否检测到 Xaero’s Minimap。
进入任何有 MTR 网络的服务器（单人世界也行）。
打开 Xaero’s World Map（默认键 Y）— 几秒内应看到 [MTR] ... 路径点出现，地图左上角出现 MTR 切换小部件。

如果什么都没出现，请参考排错指南。

验证安装

运行客户端命令：

/mtrsurveyor mode

它应回复当前路径点模式。如果报 “Unknown command”，说明 mod 没加载 — 重新检查 mods 文件夹和 Forge 版本。

升级

升级时，直接用新版 CRTools-MTR-Xaero-Mapper-*.jar 替换旧版即可。.minecraft/config/mtrsurveyor.toml 中的现有配置会被保留。新增的配置项（如果有）会在下次启动时以默认值写入。