Releases: teamCreating/MTR-Map-Overlay
Release list
v1.5.1
Fixes a NeoForge dedicated server startup crash. Previously, common initialization loaded components containing client-only classes, including JourneyMap, and registered client events. On a dedicated server, NeoForge rejected the ClientLevel class, preventing the server from starting.
Version 1.5.1 separates common and client initialization and isolates client events and network handling. Fabric retains its loader-specific adapter, and the network snapshot protocol remains at v5.
NeoForge and Fabric builds, along with the NeoForge tests, passed. A NeoForge dedicated server started successfully. Fullscreen map visuals and cross-machine multiplayer still need further verification.
Requirements remain Minecraft 1.21.1 and MTR 4.1.0-beta.2. Install only the JAR matching your mod loader. For whole-network data, install the matching version on both the client and server.
修复 NeoForge 专用服务器启动崩溃。此前，通用初始化流程会加载 JourneyMap 等包含客户端类的组件，并注册客户端事件；在 Dedicated Server 上，这会导致 NeoForge 拒绝加载 ClientLevel，使服务器启动失败。
v1.5.1 将通用初始化与客户端初始化分离，并隔离客户端事件和网络处理。Fabric 保留对应的平台适配，网络快照协议仍为 v5。
NeoForge、Fabric 构建及 NeoForge 测试通过。NeoForge 专用服务器已成功启动。全屏地图视觉效果和跨机器联机仍需进一步验证。
Minecraft 1.21.1 和 MTR 4.1.0-beta.2 的要求不变。请只安装与你使用的加载器对应的 JAR。若要显示全网数据，客户端和服务端都需要安装对应版本。
v1.5.0 - JourneyMap map-layer parity
v1.5.0 Release Notes (2026-09-25)
Compared with the previous official release, v1.4.6:
- JourneyMap now has the full rail and route layer. Its fullscreen map draws sampled physical rails and adjacent colour bands for routes sharing a rail. Independent TRACKS and ROUTES buttons use the same red/off and green/on icon convention as Xaero. With both enabled, routes sit over tracks; station and platform icons remain on top in every switch combination.
- Map-anchored rendering. JourneyMap uses Xaero-matched screen-pixel track width and the map's live pan, drag and zoom projection. The path and landmark layer stays aligned while dragging instead of floating or tearing.
- Lighter rendering and data handling. Route paths reuse sampled track geometry; rail bounds cull offscreen work on both maps; JourneyMap batches compatible icons. Snapshot chunk assembly validates order, size and metadata, and client fallback caches are cleared when changing servers.
Minecraft 1.21.1, MTR 4.1.0-beta.2, and the v5 network snapshot protocol remain unchanged. Install only the JAR matching your loader. For whole-network data, the matching mod must run on the server as well as the client; client-only use is limited to MTR's nearby data.
中文
与上一官方版本 [v1.4.6](https://github.com/teamCreating/MTR-Map-Overlay/releases/tag/v1.4.6) 相比：
- JourneyMap 现在拥有完整的轨道与线路图层。 在全屏地图中，现在会绘制经过采样的实际物理轨道；当多条线路共用同一段轨道时，还会在轨道旁显示对应线路颜色的色带。新增独立的 TRACKS（轨道） 和 ROUTES（线路） 按钮，并与 Xaero 使用相同的图标状态约定：红色表示关闭，绿色表示开启。当两者同时开启时，线路图层会绘制在轨道图层之上；无论采用哪种开关组合，车站和站台图标都会始终显示在最上层。
- 基于地图坐标的渲染。 JourneyMap 现在采用与 Xaero 一致的屏幕像素轨道宽度，并使用地图实时的平移、拖动和缩放投影。拖动地图时，路径和地标图层会持续与地图保持对齐，不再出现图层漂浮或撕裂的问题。
- 更轻量的渲染与数据处理。 线路路径会复用已经采样的轨道几何数据；两种地图都会根据轨道边界剔除屏幕外的渲染工作；JourneyMap 还会对兼容的图标进行批量渲染。快照分块组装现在会验证数据顺序、大小和元数据；切换服务器时，也会清除客户端的备用缓存。
Minecraft 1.21.1、MTR 4.1.0-beta.2 以及 v5 网络快照协议均保持不变。请只安装与你所使用的 Mod Loader 相匹配的 JAR 文件。
如果需要获取整个铁路网络的数据，服务器端和客户端都必须安装对应的 Mod；如果仅在客户端安装，则只能获取 MTR 提供的附近区域数据。
v1.4.6 - NeoForge and Fabric
v1.4.6 Release Notes (2026-09-23)
相较上一正式发布版 v1.4.4：
- 新增 Fabric 1.21.1 构建：与 NeoForge 版分别出包；两者共用地图数据、绘图逻辑和 v5 快照协议，Fabric 单独实现入口、客户端命令、配置及网络适配。Fabric 需要 Fabric API 与同平台的 MTR 4.1.0-beta.2。
- 地标不再是普通 Xaero 路标：站点、站台、车辆段改为仅在全屏地图内绘制的小图标，不进入路标列表、指南针、Minimap 或世界 HUD；旧版留下的
[MTR]路标会自动清理。JourneyMap 地标也限定在全屏地图显示。 - 地图图标稳定性与完整性：Xaero 图标与轨道共用地图坐标变换，拖动和缩放时不再按屏幕整数像素跳动；Xaero/JourneyMap 的 32×32 站点贴图改为完整采样，修复截断。
- 项目标识更名：mod ID、Java 包、资源命名空间与客户端命令统一为
mtrmap//mtrmap，不再使用mtrsurveyor标识。NeoForge 首次启动可从旧的mtrsurveyor.toml复制配置；全网同步需客户端和服务端安装使用新 mod ID 的版本。
请按加载器只安装一个 JAR。NeoForge 使用 config/mtrmap.toml，Fabric 使用 config/mtrmap.properties。两平台构建及 NeoForge 单元测试通过；未自动启动 Minecraft，Fabric 地图显示与联机同步仍待手动验证。
v1.4.4
v1.4.4
本次发布相较上一正式版 v1.0.1，完成了平台迁移，并大幅扩展地图、路线与地标功能。
更新内容
- 迁移至 Minecraft 1.21.1 / NeoForge，适配 MTR 4.1.0-beta.2；Xaero 与 JourneyMap 集成合并为同一个 mod，可按需使用。
- 完整铁路网络地图：加入服务端全网快照同步、变化探测与按维度刷新；Xaero World Map 可绘制轨道及路线。
- 路线贴合真实轨道：路线使用 MTR 生成的实际行车路径和轨道几何；多路线共线时分轨显示，悬停可查看经过该轨道的路线。
- 全图地标同步：协议 v5 同步车站、站台和车辆段；Xaero 支持站点与站台同时显示，远处地标不依赖客户端附近数据。
- 共线彩虹带：同一物理轨道只绘制一次，多条路线按稳定 ID 分色并排显示，避免互相覆盖。
兼容性
- Minecraft 1.21.1
- NeoForge 21.1.249
- MTR 4.1.0-beta.2
- Xaero's Minimap / World Map 与 JourneyMap 为可选集成。
发布记录中的 gradlew test --no-daemon 验证通过；Minecraft 实机验证需在游戏中进行。
v1.0.1
v1.0.1 Release Notes(2026-09-05)
下载说明
本 Release 附带两个独立构建产物(均为客户端 mod,可单独安装,也可同时安装):
| 文件 | 版本 | 说明 |
|---|---|---|
CRTools-MTR-Xaero-Mapper-1.0.1.jar |
Xaero 版(main 分支) | 将 MTR 车站 / 站台 / 车辆段同步为 Xaero's Minimap 航点 |
mtrjourneymap-1.0.1.jar |
JourneyMap 版(journeymap 分支) | 将 MTR 车站 / 站台 / 车辆段显示为 JourneyMap marker |
本次更新内容
移除:Xaero 世界地图路线视图(main 分支)
- 按计划移除了将 MTR 路线网络直接呈现至 Xaero's World Map 的功能(
XaeroRouteRenderer及配套的XaeroWorldMapMixin/XaeroWorldMapAccessor/XaeroMixinPlugin已一并删除)。 - Xaero 版本自此不再依赖 Xaero's World Map——航点同步仅需要 Xaero's Minimap。
- 两个版本的功能特性自此完全对齐,路线视图在两个版本中均不再提供。
统一:JourneyMap 版本(journeymap 分支)功能对齐 Xaero 版本
- 站台(Platform)模式:新增
waypointMode配置(station/platform)。- platform 模式下,每个站台一个 marker,标签为站台编号;
- 悬停显示车站名,以及每条经过该站台路线的「路线名 → 终点站」信息(支持自定义终点站、按路线名去重);
- marker 坐标取站台精确位置。
- Depot 显示:车辆段 marker 在两种模式下均可通过
showDepotLandmarks开关显示,并按交通方式(火车 / 船 / 缆车 / 飞机)使用对应图标,按站点颜色染色。 - 配置调整命令(客户端命令,任何服务器可用,与 Xaero 版命令结构一致):
/mtrjourneymap syncLandmarks— 手动触发同步;/mtrjourneymap mode [station|platform]— 查看 / 切换显示模式;/mtrjourneymap config enabled|showStations|showDepots|showEmptyStation <true/false>— 调整配置;- 每次修改自动保存并立即触发重新同步。
- 同步机制对齐:新增
ClientSyncHandler,同步请求进入客户端 tick 队列并自动重试(JourneyMap API 未就绪、MTR 数据未同步时不会丢失请求);玩家切换维度时自动重建 marker。 - 服务端命令移除:原需权限等级 4 的服务端
/mtrjourneymap syncLandmarks [dimension]已由上述客户端命令取代;MTRSimulatorMixin改为空操作(marker 属客户端内容,专用服务器上不存在 JourneyMap API,原写法在服务器端有崩溃风险)。
保留:Xaero 版本既有特性(纯客户端运行)
- 全面解耦服务端数据依赖:调取本地 Dashboard 与活动 Client 实例节点直接映射渲染,可顺畅连接至未安装本 Mod 的外部或第三方多人服务器。
修复与底层优化
- JourneyMap marker 重复 ID 修复:JourneyMap API 拒绝对已显示的 ID 再次调用
api.show(),原逻辑每次同步会持续报错且无法更新。现改为每次同步先移除旧 marker 集再整体重建。 - marker ID 生成修复:Station / Depot / Platform 的共同基类是
NameColorDataBase而非AreaBase(Platform 属于 SavedRailBase 体系),原实现对站台生成 marker 时会失败。 - 构建环境修复:两个分支的
gradle.properties改为指向本机 JDK 21;journeymap 分支 gradle wrapper 由 8.12 调整为 8.8。
部署及兼容说明
- 目标环境架构: Forge 1.20.1
- 依赖运行基准版本:
MTR v4.0.2-hotfix-1或以上版本- Xaero 版本(main 分支):
Xaero's Minimap v25.3.10或以上版本(不再需要 Xaero's World Map) - JourneyMap 版本(journeymap 分支):
JourneyMap 1.20.1(可选,提供 marker 显示)
v1.0.0
v1.0.0 Release Notes
新特性
- Xaero 世界地图路线视图集成
- 新增将 MTR (Minecraft Transit Railway) 路线网络直接呈现至 Xaero's World Map 的支持。
- 实现基于环境矩阵投影的坐标转换与制图算法，支持在世界地图层面上渲染出平滑的真实 MTR 轨道曲线。
- 引入依赖模块按需加载逻辑 (
XaeroMixinPlugin)。模块会在运行初期自动检测整合包内的依赖状态，并在未发现对应 Mod 时安全略过注入加载，彻底解决因缺失依赖引发的运行宕机和崩溃问题。
- 全面解耦的服务端数据访问依赖 (纯客户端运行)
- 移除了强制依赖 MTR 服务端数据作为唯一基准的限制，重写了底层缓存提取与状态同步流程。
- 新机制调取已获取同步的本地 Dashboard 和活动 Client 实例节点直接映射渲染车站路线。该项调整允许模块作为独立客户端支持组件，顺畅连接至未安装本 Mod 的外部或第三方多人服务器。
- 规避并修复了原先由服务端强制切入并接管跨网络广播数据导致的同步脱节 (Desync) 和高频率崩溃问题。
修复与底层优化
- 环境数据对象读取优化：提高了对线路平台、各级车站以及车辆存放段 (Depots) 附带路线资料数据的提取成功率。解决了在界面初检并获取站点名称时偶发的空指针引用和遗漏现象。
- 地图坐标路标机制梳理：重构了同步坐标地标 (Waypoints) 至 Xaero 界面环境的遍历与分发逻辑。修补了多点复用引发地图加载逻辑混乱，以及因区块迭代刷新导致标记坐标重复叠加的漏洞。
部署及兼容说明
- 目标环境架构: Forge 1.20.1
- 依赖运行基准版本:
MTR v4.0.2-hotfix-1或以上版本Xaero's World Map v1.40.11或以上版本Xaero's Minimap v25.3.10或以上版本
Full Changelog: https://github.com/teamCreating/MTR-Xareo-Mapper/commits/V1.0.0