文档
轨道与线路
物理铁轨、多线共轨彩色带与图层渲染机制。
两个核心图层
模组把铁路网络拆成两个图层进行渲染:
- Tracks(铁轨图层):直接从 MTR 采样读取到的 TRAIN 物理铁轨线。
- Routes(线路图层):依附在铁轨上绘制的 MTR 线路颜色带。
- 车站、站台等地标图标始终画在这两个图层的上面。
修铁路时经常有多条路线共用同一段铁轨。当遇到共轨区段时,模组会把每条线路的颜色并排画成多条彩色带,而不会互相覆盖。因为线路色带和铁轨走的是同一套曲线采样数据,所以路径永远严丝合缝、完美贴合。此外,不在屏幕视口里的铁轨会自动剔除,绝不浪费多余的渲染性能。
图层控制
在 Xaero 世界地图或 JourneyMap 的界面上,都有独立的 TRACKS 和 ROUTES 按钮,点一下就能单独开关对应图层。
如果你想修改默认开启状态,也可以在配置文件中修改 trackLines 与 routeLines,或者在游戏内直接用指令修改。
数据覆盖范围
只在客户端安装模组时,受 MTR 原版机制限制,地图上只能显示已同步到玩家身边的附近数据。
如果在服务端也装上 MTR Map Overlay,客户端就可以向服务端请求每个维度的全网路网快照。想要拉取最新数据时,输入 /mtrmap syncRoutes 即可。
注意:目前渲染器只针对 MTR 的 TRAIN(常规列车)模式铁轨进行采样,MTR 中的其他交通模式(如索道、船等)暂时不会绘制物理轨道线。
线路样式与平滑曲线
从 1.5.2 版本开始,我们细化了不同车型的线路绘制样式:
- 轻铁(Light Rail):宽度采用标准宽度的 70%,在地图上更显轻巧。
- 普通铁路与高铁(High Speed):保持标准宽度。其中高铁线会画成带线路色外框、内部彩白交替相间的斑马纹,一眼就能认出来。
模组支持自适应平滑曲线,多线共轨的总宽度也会跟随地图缩放自动调整。需要说明的是,地图渲染目前采用的是固定的 2D 平面层级,虽然内部完整保留了真实的 Y 轴高度数据,但目前不会对立体交汇立交桥做上下遮挡剔除。
另外,通过 1.5.3 导航扩展 API,第三方导航模组可以高亮你当前需要乘坐的线路区段,同时把已经坐过的路段和没用到的背景铁轨半透明淡化(包括高铁的白斑块和铁轨底衬都会同步变暗),导航指引更加直观。