排错与常见问题

地图上只能看到自己附近的铁轨和车站？

这是因为你只在单机客户端安装了模组。当服务器没有安装 MTR Map Overlay 时，它只能显示 MTR 已经同步到你角色周围的一小圈铁轨和站点数据。

想要在全屏地图上看到整个维度里的完整铁路网，服务器上也必须装上对应版本的 MTR Map Overlay。两端都安装后，在游戏里输入 /mtrmap syncRoutes 就能立即拉取完整的全网快照。

地图上完全不显示铁轨或线路？

请逐项排查：

• 版本是否匹配：确认 MTR Map Overlay 的 jar、MTR 和地图模组全部匹配你的 Minecraft 版本和加载器。MC 1.20.1 和 1.20.4 需要搭配 MTR 4.0.5（Forge 或 Fabric）；MC 1.21.1 需要搭配 MTR 4.1.0-beta.2（NeoForge 或 Fabric）。
• 是否打开了全屏地图：铁轨和图标只会渲染在全屏大地图上（按 M 或相应快捷键打开 Xaero’s World Map 或 JourneyMap），小地图（Minimap）或游戏屏幕 HUD 是不显示的。
• 图层开关是否开启：检查地图界面上的 TRACKS（铁轨）和 ROUTES（线路）按钮是否为亮绿色开启状态；也可以在聊天框输入 /mtrmap config trackLines true 和 /mtrmap config routeLines true 强制开启。
• 查看游戏日志：如果地图模组刚刚更新了版本，内部渲染钩子可能发生变动。请检查 .minecraft/logs/latest.log 中是否有带 mtrmap 的报错信息。

为什么站点图标没有显示在小地图或路径点列表里？

这是有意设计的！MTR Map Overlay 是把车站和站台直接绘制在全屏大地图的画布图层上的，而不是生成传统的 Waypoint 路径点。这样可以避免几百个车站挤满你的小地图、雷达指南针、路径点管理列表或者在屏幕中央乱晃。

输入 /mtrmap 提示未知指令？

通常是因为安装了不匹配的构建，或者还留着旧版本。请确保你安装的是 v1.6.0，且 jar 文件名上的 MC 版本和加载器（Forge/NeoForge/Fabric）与当前游戏环境一致。

服务器必须安装这个模组吗？

• 基础体验（仅客户端）：非必须。你可以带着它加入任何装了 MTR 的普通服务器，地图上能正常显示你身边的铁轨和车站。
• 完整体验（双端安装）：强烈建议安装。只有当服务器也装了模组时，才能解锁全图跨区域路网快照、全维度实时运行列车追踪，以及车站原生 PIDS 实时到站屏。

支持哪些 Minecraft 版本和模组加载器？

• Minecraft 1.21.1：NeoForge 或 Fabric。
• Minecraft 1.20.1：Forge 或 Fabric。
• Minecraft 1.20.4：Forge 或 Fabric。

具体的 MTR、Java 和地图模组版本要求，请查看兼容性矩阵。

车站到站屏（PIDS）为什么只显示横杠 -，没有具体时间？

实时到站看板需要客户端和服务端同时安装匹配的 1.6.0 版本。

在地图上点击车站并展开（Expand）后，到站板会直接向 MTR/TSC 的原生 PIDS 系统请求到站预测。如果当前对应站台没有任何班次正在发车或调度运行，它就会明确显示横杠（-），而不是显示一个误导性的 0 分钟。

车站卡片里的 Navigate 按钮为什么点不了？

Navigate（导航）按钮是预留给第三方路线规划与导航模组接入的接口。MTR Map Overlay 本身专注于地图展示与 API 联动，并不内置独立的路径规划算法。在 1.6.0 中，已注册的服务还需要能处理当前车站，这个按钮才会点亮；多个服务时，选择菜单只显示当前可用的服务。

实时列车只在身边才显示？

请先检查列车图层是否开启（/mtrmap config trainCars true），并确认服务器上也安装了 MTR Map Overlay。全图维度的列车实时同步需要服务端模组广播列车运行坐标，详见实时列车。