文档
兼容性与版本支持
Minecraft 1.20.1、1.20.4、1.21.1 构建的加载器、MTR 依赖与验证情况。
支持平台
| Minecraft | 加载器 | Java 运行时 | MTR | 地图集成 |
|---|---|---|---|---|
| 1.21.1 | NeoForge 21.1.x 或 Fabric + Fabric API | 21 | 4.1.0-beta.2 | Xaero 世界地图 1.45.0+；JourneyMap 6.0.8+ |
| 1.20.1 | Forge 47.x 或 Fabric + Fabric API | 17+ | >=4.0.5, <4.1 | Xaero 世界地图 1.45.0+；JourneyMap 6.0.6+ |
| 1.20.4 | Forge 49.x 或 Fabric + Fabric API | 17+ | >=4.0.5, <4.1 | Xaero 世界地图 1.45.0+；JourneyMap 5.10.0 |
MTR 和地图模组都必须与你选定的 Minecraft 版本及加载器严格对应。在代码维护上，1.20.1 和 1.20.4 构建来自仓库的 MC 1.20 兼容分支，而 1.21.1 构建则在 main 主分支上持续迭代。
Xaero 小地图（Xaero’s Minimap）仅为可选依赖，唯一的作用是如果你之前装过旧版，它能自动帮你清理掉遗留在小地图上的 [MTR] 旧路标。新版本的车站图标全部直接绘制在全屏世界地图上，不会污染小地图。
选择对应的 jar 包
每个 Minecraft 客户端或服务端只装一个对应的 jar 包即可：
- 1.21.1：挑选 NeoForge 版或 Fabric 版。
- 1.20.1 / 1.20.4：挑选 Forge 版或 Fabric 版。
- Xaero 世界地图和 JourneyMap 都是可选的，你可以按喜好二选一，或者两个都装上。
如果仅在客户端安装，地图上会显示玩家身边的 MTR 附近数据。想要获取全维度的完整路网快照与全图实时列车，服务端也需要装上对应版本的本模组和 MTR。
v1.6.0 验证与发布状态
v1.6.0 已在 GitHub 正式发布，是当前最新稳定版。全部 6 个构建均支持逐站 Navigate 可用性检查和四语言界面，保留站点到站屏（PIDS）、英式/欧式双样式、实时列车以及公共导航 API。MC 1.20 构建基于 MTR 4.0.5 验证，声明兼容范围为 >=4.0.5, <4.1。
在开发环境中，我们已经完成了全部 6 个目标平台和双地图模组的基础功能测试，包括站点卡片固定、展开/折叠、原生预测倒计时以及英式/欧式 PIDS 样式切换。 v1.6.0 已修复之前 Forge 1.20.4 单人 Quick Play 的加载问题，以及 Forge 1.20.1 连接未装 Overlay 服务器时的附近数据降级。如果 Forge 1.20.1 启动器自动直连超时，可以改用游戏内多人服务器列表连接。
更详细的测试与发布包检查见 1.6.0 实机记录和发布验证。