文档

配置

mtrsurveyor.toml 中的每个配置项,含类型、默认值与说明。

MTR Surveyor 把配置存在 Forge 配置文件中:

.minecraft/config/mtrsurveyor.toml

首次启动时自动生成。可在游戏关闭时直接编辑,也可在运行时通过 /mtrsurveyor config 命令修改最常用的几项(改动会写回同一文件)。

文件分两部分:顶层选项和 [visibility] 表。

顶层选项

类型默认值说明
formalInitLogboolfalse使用更正式的启动日志文案,替代默认的俏皮文案。
debugLogboolfalse将每次地标同步事件记录到控制台。排错时有用。
enabledbooltrue自动路径点同步总开关。设为 false 时不同步。
waypointModestring"station"显示模式:"station"(每站一个路径点)或 "platform"(每个站台一个路径点并带路线信息)。

[visibility] 选项

类型默认值说明
showStationLandmarksbooltrue为 MTR 车站添加路径点。
showDepotLandmarksboolfalse为 MTR 车厂添加路径点(前缀 [MTR] Depot:)。
showEmptyStationboolfalse为没有路线的空车站添加路径点。
showHiddenRouteboolfalse在车站描述中包含 MTR 标记为隐藏的路线。

示例文件

#Change the mod initialization log message to be something more formal
formalInitLog = false

#Log all landmark sync events to the console
debugLog = false

#Whether waypoints should be automatically created & synced when an MTR-related change occurs
enabled = true

#Waypoint display mode: 'station' shows one waypoint per station, 'platform' shows one waypoint per platform with route info
waypointMode = "station"

[visibility]
    #Whether station waypoints should be added to the map
    showStationLandmarks = true
    #Whether depot waypoints should be added to the map
    showDepotLandmarks = false
    #Whether empty stations (with no routes) should be added to the map
    showEmptyStation = false
    #Whether MTR routes marked as hidden should be appended to the station description
    showHiddenRoute = false

说明

  • waypointMode 只接受 "station""platform"。其他值会回退到车站模式行为。
  • enabled = false 会完全暂停同步;既有的 [MTR] 路径点不会被移除,直到你重新启用并触发一次同步。
  • debugLog = true 日志很吵 — 仅在排查问题时开启,事后请关闭。
  • 三个可在运行时切换的选项(enabledshowStationLandmarksshowDepotLandmarks)已暴露为 /mtrsurveyor config 命令。其余四个只能编辑文件。