排错与常见问题

只能看到附近轨道或地标

这是纯客户端回退行为。要启用全网快照，请在服务端也安装匹配的 MTR Map Overlay 和 MTR，然后使用 /mtrmap syncRoutes 请求刷新。

没有轨道或路线

• 确认 MTR Map Overlay、MTR 和地图 mod 均为 Minecraft 1.21.1 且使用相同加载器。
• 打开全屏地图，而不是小地图或游戏内 HUD。
• 确认 TRACKS 和 ROUTES 按钮已开启，或在配置中启用 trackLines 与 routeLines。
• Xaero 世界地图的渲染器更新可能影响集成；检查游戏日志是否有 MTR Map Overlay 错误。

为什么小地图上没有路标？

当前版本只在全屏地图中绘制地标，不会写入路标列表、指南针、小地图或 HUD。Xaero 小地图为可选项，只用于清理旧版遗留的 [MTR] 路标。

找不到命令

当前客户端命令是 /mtrmap。请移除旧版 MTR Map Overlay，并为当前加载器安装 1.5.0。

服务端必须安装吗？

查看附近数据不需要；获取全网快照则需要客户端和服务端都安装。

支持哪些加载器和游戏版本？

Minecraft 1.21.1、NeoForge 21.1.x 或 Fabric Loader + Fabric API。MTR 和地图 mod 也要使用对应加载器版本。