查换乘、看班次，让下一段旅程更清楚。
实际界面 · 快速开始 · 安装与兼容 · Overlay 对接 · 反馈问题 · English
MTR：站间物语是一个独立的 Minecraft Transit Railway 导航附属模组。你可以查找车站、比较换乘方案、查看站台到发，或为某一班列车设置到站提醒。界面采用 Minecraft 原版控件，配合像素边框与黄铜装饰；不需要安装机械动力。
当前版本：0.1.0-alpha.1（公开测试版）。 下载本次 Alpha · 更新记录。 提供 NeoForge 和 Fabric 构建包；NeoForge 已有联机实测记录，Fabric 的游戏内完整验证及两个加载器的专服完整验收尚未完成。新增界面和提醒也仍需实机复查，详见验证记录。
- 找车站：直接输入中文或英文完整站名，或打开独立的“全部车站”页面搜索、滚动选择。支持 A–Z／Z–A／离我最近 排序和字母索引快速跳转；同名站显示坐标，选中行用金色边框、箭头和亮底色标识。
- 查换乘：支持“最快到达”“少换乘”排序，最多展示五种不同走法；同一走法的后续车次不重复占名额。默认只保留比本次最快晚到不超过30分钟的备选，可在查询设置中调整。
- 步行换乘：在独立页面录入站到站或站台到站台的连接，支持双向个人保存和 JSON 导入、导出。步行时间计入赶车判断，HUD 提示后由玩家手动确认到达；不会仅凭距离近就认定可通行。
- 共享审核：安装新版服务端后，玩家可以提交共享建议，OP等级2及以上管理员审核通过才发布。个人连接与共享库分开；用于服务端查询前需要明确同意，不会自动公开。
- 看班次：到发页按线路分组，展开查看已同步的班次，分别显示到达与发车倒计时，以及来源提供的实时／计划标识。
- 设提醒：点击具体班次，默认到站前 9 分钟提醒，可调为 1～60 分钟。关闭窗口后继续更新，顶部通知条在触发时展开并播放一次提示音。
- 途中导航：开始行程后，由 HUD 提示下一操作；可手动确认上车、下车或返回上一步，也可调整 HUD 的位置和大小。
- 看线路参考：有换乘路径但暂时找不到可乘班次时，仍展示线路连接，并说明无班次、超出范围或计算未完成；不编造到发时间。
以下图片于 2026-10-26 在 Minecraft 1.21.1／NeoForge 21.1.251 联机客户端拍摄。站名、线路和到发时间来自截图时的服务器数据；HUD 设置页展示的是预览。点击图片可查看原图。
在左侧比较耗时、换乘次数和线路摘要，右侧查看乘车方向、上下车站台、步行与候车安排。悬停方案卡片可查看完整摘要，列表和详情分别滚动。
到发按线路分组。展开后分别显示站台、到达和发车倒计时，以及来源标记的实时／计划状态；点击具体班次可以设置提醒。
在独立目录里搜索，切换 A–Z、Z–A 或距离排序，也可点字母快速跳转。金色边框和箭头标明当前选中项，底部直接选择用途。
导航框和班次提醒框在同一页预览，各自调整位置与大小。拖动提示框、滚轮缩放，也可使用四角预设；两个框自动避让。图中 03:20 是设置预览示例。
查看步行连接编辑表单
依次选择从哪里出发、走到哪里，填写分钟和秒；站台、名称与说明可选填。保存个人连接和提交共享建议是两个独立操作。下图为未填写、未保存的新建表单。
需要 Minecraft 1.21.1、Java 21、MTR 4.1.0-beta.2。
- NeoForge 21.1.x：安装
MTR-Navigation-neoforge-0.1.0-alpha.1.jar。 - Fabric Loader 0.16.14 或更新版本：安装
MTR-Navigation-fabric-0.1.0-alpha.1.jar，另需 Minecraft 1.21.1 对应的 Fabric API。
将对应的一个 JAR 放进游戏实例的 mods 文件夹。更新前退出游戏，移走旧 Navigation JAR，确保只保留一份；不要把两个加载器的包一起安装。
客户端需要安装本模组，服务端可选。 新版多方案与步行查询需要原生兼容模式或新版 Navigation 服务端；连接仅支持旧 v1 协议的服务端时，保留最多三个纯乘车方案，新功能明确显示不可用。
- 服务端只有 MTR：客户端尝试通过 MTR 原生地图服务获取线路和到发数据。该服务必须可用，行程进度需手动确认。
- 服务端也安装本模组：使用专用全网查询服务；只有可靠关联到玩家乘坐的车辆时，才使用自动进度，否则继续提供手动校正。
- MTR Map Overlay 是可选兼容项：可以只读复用其已经同步的车站目录，但地图快照不能代替班次时刻。已有 Overlay 不代表原生时刻服务必然可用。
仓库名为 MTR-Navigation，模组 ID 为 mtrnav。当前查询仅支持本维度的铁路客运。
- 按 N 或输入
/mtrnav打开界面，快捷键可在控制设置中修改。 - 输入起终点的完整站名；也可点 全部车站，选中后分别设为起点、终点。
- 点 查询，切换排序并比较候选方案，确认后点 开始导航。
- 上车后点 已上车，下车后点 已下车，继续；操作错误时用 上一步 校正。
- 关闭窗口后 HUD 继续提示，按打开键返回。
快速查站：全部车站右上可切换排序；宽窗口直接点击字母，窄窗口点击“索引”。英文名优先做字母归组，纯中文按常用汉字拼音首字母归组；数字在“#”，无法归组的在“其他”。距离按当前位置的水平直线估算，点击“重新定位”刷新，未知距离排在最后。详见车站目录操作。
点击行程详情中的车站可查看到发；点击详情标题可展开途经站。重新查询不会直接替换正在执行的行程，需要再次选择方案。点击或用Tab进入车站输入框时会全选原站名，直接输入新站名即可替换；再次点击可局部编辑，右侧 × 仍可清空。切到到发页也会自动选中当前站名，输入后按回车查询。
起点定位：每次连接首次进入换乘查询、起点为空且未经编辑时，自动根据玩家位置选择附近车站。也可点击准星图标 定位 重新选择；窄窗口仅显示图标。最近站在512格内，且比第二近站近超过64格时自动填入；否则打开独立的 附近车站 页面，按距离排序后由你确认。页面保留搜索、滚轮、拖动滚动条和键盘操作；点击 重新定位 才更新距离基准。
距离是当前维度内到车站坐标的水平直线估算，不代表入口或步行距离。未知坐标的站仍能手动搜索，但不参与定位。手动修改、交换或清空起点后，不会自动填回；定位也不会自动查询或替换活动导航。
打开 车站到发，选择车站，点击线路标题展开班次。列表支持滚轮与拖动右侧滚动条；自动刷新保留线路展开状态。
点击某一班次可设置提醒，时间以该列车到达所选车站为准。保存时已经进入提前窗口，会在数据确认后立即触发。
- 提醒条默认位于顶部中央，自动收起时仍保留线路、车站、倒计时、方向、站台与状态；设置和触发时短暂展开。HUD设置或提醒设置中均可切换 保持展开。提醒框的位置和大小可独立调整。
- 数据超过五秒未更新、采样过旧或不能确认所选记录时，显示 班次待确认，暂停可靠倒计时与提醒。
- 发车时间已过时显示相应提示，不直接判断你是否已经上车，也不会自动换成下一班。
- 顶部 提醒 可更新或取消提醒。只有提醒、没有导航行程时，按打开键优先进入提醒管理。
每次连接最多保留一个提醒；替换其他班次需要明确点击替换。提醒不跨会话保存，断线、切服或切维度时清除，最后已知发车时间过去十分钟后过期。
到发页展示的是当前数据范围内的班次，不是全天时刻表。请求上限为每站台 32 班、每车站 512 班，实际来源可能返回更少数据。
点顶部 HUD 打开统一设置页，选择 导航框 或 班次提醒框；也可直接点击要调整的预览框。拖动改位置，滚轮或加减按钮改所选框的大小，四角预设和恢复默认也只作用于所选框。两个框各自保存位置与大小，设置页同时预览，拖动时设置面板收起。
两个提示框同时显示时会自动避让，提醒框即使收起也按展开尺寸预留空间。小窗口放不下时会临时缩小，关闭自动适配也保留防重叠保护，不会覆盖保存的位置。自动收起／保持展开也在同一页设置，详见双HUD设置说明。
大小范围为 75%～200%。位置按可用屏幕区域的比例保存，切换分辨率后仍保持在屏幕内；配置位于游戏实例的 config/mtrnav-client.properties。
点击查询页的 步行换乘，可以调整晚到范围为15、30、60分钟或不限，也可管理 服务器共享／仅自己／我的提交／审核管理。没有 Navigation 服务端时默认打开个人连接；客户端仍可通过 MTR 原生时刻服务计算。
新建时依次选择出发站、到达站及可选站台，直接填写分钟和秒（总计10秒～60分钟），名称和说明可选填。保存个人连接与提交共享建议是两个不同操作。默认同时保存反向个人连接；两条方向可分别修改，共享时逐方向提交审核。未知或失效端点不参加查询。
服务端查询个人连接前会征得同意。服务器只为本人计算，不把个人规则写入共享库或发给其他玩家；该选择按服务器保存，可随时关闭。共享连接优先于个人连接，人工步行时间不会再叠加坐标距离估算，上车余量单独计一次。
步行阶段点击 已到达，继续 才进入下一步。接近目标只是提示；规则变化、步行超时或赶不上原班次时会提示重新查询，不自动替换活动行程。
详见步行换乘与共享管理，包含数据位置、权限、限制、导入格式及验证范围。
查到时刻，不等于知道你实际上了哪一班车。 原生兼容模式缺少完整车辆身份，上车和下车需手动确认；预计到站提醒也不是对玩家所在列车的定位。到发页的“实时／计划”标识以 MTR 返回的数据为准。
默认有时间方案的查询范围是未来六小时、最多四次换乘，换乘额外预留 30 秒；基础换乘使用同站及 MTR 明确连接的车站。服务端安装本模组后，可通过 config/mtrnav.properties 调整这些参数。
额外步行连接必须由玩家明确录入或经服务器审核发布；不包括道路寻路和通行检查。首尾可包含一条步行连接，但不生成纯步行方案，不串联多条站外步行连接。
“暂无可乘班次”只描述当前查询结果，可能是不在运营时段、超出查询范围或时刻数据不完整，不能据此确认整条线路停运。线路参考可以展示更远的拓扑路径，但没有确认班次时不能启动班次导航。
查询按需进行：没有打开导航界面、活动行程或提醒时停止轮询。原生请求串行处理；服务失败后暂停自动请求，至少十五秒后可由用户重试。同站的到发和提醒复用数据，不触发 Overlay 全量同步。
- Overlay 对接指南：公共 API、选择／更新／取消事件、环线重复停靠、精确乘车区间与接入示例。
- 步行换乘与共享管理：个人配置、审核、发布、网络边界与开发验证方法。
- 验证记录：已完成的构建、回归、实测及尚未覆盖的边界。
- 早期布局演示：浏览器原型与示例数据，供布局讨论使用，不代表当前界面截图。
NavigationApi 发布不可变的 JourneySelection，不要求 Overlay 成为硬依赖。实际地图区间高亮尚未实现；线路参考及班次提醒不会替换活动导航的地图选择。
先准备 Java 21，并设置 JAVA_HOME。通过项目脚本启动，确保缓存和临时文件保存在项目内。
python tools/download_dependencies.py
.\dev.ps1 -Platform neoforge build testFabricCore
.\dev.ps1 -Platform fabric buildLinux／macOS 对应使用 ./dev.sh neoforge build testFabricCore 和 ./dev.sh fabric build。
产物分别位于 build/libs 和 fabric/build/libs。Gradle、依赖与工具缓存位于 .cache，临时文件位于 .tmp，开发游戏实例位于 run／run-server；这些生成目录不提交到仓库。分发后的配置使用玩家自己的游戏实例目录。
MTR: Between Stations is an independent navigation add-on for Minecraft Transit Railway. It provides a searchable station directory, transfer planning, grouped station arrivals and departures, journey guidance, and reminders for individual trains.
Requires Minecraft 1.21.1, Java 21 and MTR 4.1.0-beta.2. Separate NeoForge 21.1.x and Fabric builds are available; Fabric also requires Fabric API. Install one matching JAR on the client. Installing Navigation on the server is optional, but client-only operation requires the server's native MTR map service to work.
The in-game screenshots show the current NeoForge multiplayer UI: route comparison, grouped departures, alphabetical station browsing, the shared two-HUD editor, and the walking form. HUD editor countdowns are preview examples.
Press N or use /mtrnav. Use All stations to choose an origin, destination or arrivals station. Cycle A–Z, Z–A or nearest sorting, and jump by letter using the index. English names are preferred for grouping; supported Chinese names use their pinyin initial, with unsupported initials in Other. The selected row has a brass border and arrow. Clicking or tabbing into a station field selects its existing name so typing replaces it; switching to arrivals also selects the current station name. Compare connections, start a journey, and confirm boarding or alighting when automatic progress is unavailable. Close the screen to keep the journey HUD active.
An untouched, empty origin is located automatically once per connection; the crosshair Locate button samples your position again. A clear nearest station within 512 blocks is filled directly (more than 64 blocks nearer than the runner-up); ambiguous or distant choices open a separate Nearby stations page. Distances are horizontal estimates to station coordinates, not walking routes. Editing or clearing the origin disables automatic refill. Unknown coordinates are excluded, and location adds no network polling.
Click a train on the arrivals board to set a reminder, 9 minutes before arrival by default, adjustable from 1 to 60 minutes. A compact notification, at the top centre by default, expands when triggered. The shared HUD settings page edits the navigation and reminder panels separately: drag either preview, scroll to resize it, or choose a corner preset. Their positions and sizes are saved independently. Expanded reminder space is reserved to prevent overlap; very small windows may temporarily shrink both panels. Keep-expanded mode is available in the same page. Stale or ambiguous data pauses the reminder; it never silently switches to the next train. One reminder is retained per connection and is cleared on disconnect or dimension change.
Native compatibility mode cannot reliably identify the player's actual train, so journey progress needs manual confirmation. Live and scheduled labels follow the source data. Queries cover passenger rail in the current dimension; a route reference without confirmed train times cannot start a timed journey. Full-day timetables and map-track highlighting are not included.
New queries return up to five distinct route patterns, with a default extra-arrival window of 30 minutes (15 / 30 / 60 / unlimited). Explicit walking links can be managed in-game and imported or exported as JSON. Walking durations and the boarding buffer are counted separately; walking progress requires manual confirmation. Nearby stations are never automatically assumed to have a passable connection.
With an updated Navigation server, players may submit proposals for moderators (operator level 2+) to approve. Pending proposals are visible only to their author and authorized moderators. Personal rules require explicit consent before being sent for a private server-side query; they are not published or included in shared audit data. Servers with only the old v1 protocol retain the original rail-only queries. See the walking guide for limits and verification details.
Current version: 0.1.0-alpha.1 (public alpha). Download · Changelog. NeoForge has multiplayer test records; complete Fabric in-game and dedicated-server validation remain unfinished. See the verification notes and Overlay integration guide for precise scope.
本项目使用 MIT 许可证。部分 Gradle wrapper、MTR accessor 思路和测试网络生成器复用自 MTR Map Overlay，其原作者署名与 MIT 授权见 NOTICE。