diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 523ab52..66edf6f 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,76 +1,42 @@ # v1.5.3 (2026-10-26) -Compared with v1.5.2, this release adds native station arrival boards, two PIDS themes and a public API for third-party navigation views. +Compared with v1.5.2, this release adds native station arrival boards, British and European PIDS styles, and a unified map-view API for third-party navigation mods across all six supported builds. -## Added - -- **Pinned station information and native arrivals.** Click a station to keep its original station/platform/route information open. The card starts collapsed; **Expand** shows the next available services by destination, line and platform, using the same MTR/TSC arrival-data interface used for PIDS. Closing or collapsing the board releases its subscription. Missing predictions are displayed explicitly rather than as zero-minute arrivals. -- **British and European/airport PIDS styles.** British black/amber is the default. Use `/mtrmap config pidsStyle british` or `/mtrmap config pidsStyle european` to switch immediately and save the choice. Omit the style argument to query the current setting. -- **A unified navigation/view API.** Third-party mods can read native station/route/stop/path identifiers, resolve route sections, open owned view sessions and subscribe to station boards. They can highlight upcoming sections while independently dimming completed sections and unused lines, including different sections of the same physical rail. The **Navigate** entry supports registered providers and a chooser when several are available. It is disabled when no provider is installed; this release does not include an MTR-Navigation/howtogo-specific adapter. - -## Optimized and fixed - -- Reused native MTR/TSC arrival predictions without adding a client-side transit simulation. Station interests share server collection/encoding, with bounded leases, queues, paced chunks and fair transmission across players and interests. Clients decode in the background and reject stale snapshots. -- Preserved the classic station card and Xaero ROUTES/TRACKS controls. Improved narrow-window summaries, long-text hover details, aligned PIDS columns and ETA readability. Panel scrolling and clicks are intercepted before map zoom/pan actions. -- Fixed rail layers and the player arrow appearing over station panels. Retained separate Forge 47/49 input/network adapters and JourneyMap 5/6 rendering bridges. -- Navigation dimming applies consistently to route colours, high-speed white blocks, feathered edges and physical backing. Overlapping upcoming sections remain bright even when an earlier navigation leg uses the same track. -- All six builds include these features. Whole-map live trains, native XYZ storage and pure 2D rendering remain available; vehicle-hover ETA/next-stop distance is still deferred. - -## 中文更新说明 - -相较 v1.5.2，新增原生站点到站板、英式/欧式两套 PIDS，以及供第三方导航模组接入的统一地图视图 API。 - -### 新增功能 - -- **站点点击固定与原生到站预测**：保留原站点、站台和线路信息，默认折叠；点击 **Expand** 后按目的地、线路和站台显示下一班可用服务。直接使用 MTR/TSC 给 PIDS 的到站数据接口；无预测明确显示缺失，折叠或关闭后释放订阅。 -- **两种 PIDS 样式**：默认英式黑底琥珀字，可用 `/mtrmap config pidsStyle british|european` 即时切换并保存；不带样式参数可查询当前设置。 -- **统一导航/显示接口**：第三方可读取原生站点、线路、停站序号和路径目录，解析区段并控制独立视图。待乘区段保持明亮，已走区段和未用线路可分别变暗，同一物理轨道也能按区段控制。预留 **Navigate** 入口及多 provider 选择；没有 provider 时禁用。本版未内置特定导航模组的适配器。 +### Added -### 优化与修复 +- **Pinned station information and native arrivals.** Click a station to keep its original station, platform and route information open. The card starts collapsed; **Expand** shows the next available services by destination, line and platform. Predictions come directly from the MTR/TSC data interface used for PIDS, with missing predictions shown explicitly. +- **British and European/airport PIDS styles.** British black/amber is the default. `/mtrmap config pidsStyle british|european` switches the style immediately and saves the choice; omit the style argument to query the current setting. +- **A unified navigation and display API.** External mods can read native stations, routes, stops and path sections, subscribe to arrival boards, and control independent map views. Upcoming sections can remain bright while completed sections and unused lines are dimmed separately. The **Navigate** entry supports registered providers and a chooser when several are available; third-party mods supply the navigation integration. +- **The same features on all six platforms.** NeoForge/Fabric MC 1.21.1 builds target MTR 4.1.0-beta.2; Forge/Fabric MC 1.20.1 and 1.20.4 builds target MTR 4.0.5. Native station arrivals require matching client and server Overlay versions. -- 服务端共享原生预测采集和编码，增加租约、容量限制、后台队列、分片节流与玩家/订阅轮转；客户端后台解码并拒绝旧快照，不维护第二套行车模拟。 -- 恢复旧式站点信息框与 Xaero ROUTES/TRACKS 控件；改善小窗口摘要、长文本悬停、表格列对齐和 ETA 显示，防止面板操作误触地图缩放/拖动。 -- 修复轨道和玩家箭头覆盖站点面板的问题，保留 Forge 47/49 和 JourneyMap 5/6 的独立兼容处理。 -- 导航 dimmed 同时作用于线路色、高铁白块、边缘及物理底衬；后续乘车区段重复使用同一轨道时保持明亮。 -- 六个平台同步提供本次功能；继续保留全图列车、真实 XYZ 和纯 2D 绘制。列车悬停 ETA/下一站距离仍暂缓。 +### Optimized and fixed -## Choose the matching file / 下载环境 +- Shared native arrival collection and encoding on the server, with subscriptions released when boards are collapsed or closed. Bounded queues, paced chunks and fair scheduling reduce repeated work and prevent large catalogues from monopolizing updates. Clients decode snapshots in the background without running another transit simulation. +- Preserved the classic station card and Xaero ROUTES/TRACKS controls. Improved narrow-window summaries, long-text hover details, PIDS column alignment and ETA readability; panel clicks and scrolling no longer trigger map pan or zoom. +- Fixed tracks and the player arrow appearing over station panels. Retained loader-specific Forge 47/49 networking and input handling, plus JourneyMap 5/6 rendering bridges. +- Applied navigation dimming consistently to route colours, high-speed white blocks, soft edges and rail backing. Upcoming sections remain bright when a later navigation leg reuses the same track. Whole-map trains and pure 2D rendering remain available. -Install **one** mod JAR matching the exact Minecraft version, MTR version and loader. Native station arrivals and whole-map trains require matching client/server Overlay versions; client-only installations cannot provide the server snapshot service. +### 中文更新说明 -按游戏版本、MTR 版本和加载器选择**一个** JAR。原生站点预测及全图列车需客户端和服务端安装匹配版本；仅客户端安装无法提供服务端快照服务。 +相较 v1.5.2，本版新增原生站点到站板、英式与欧式 PIDS，以及供第三方导航模组接入的统一地图显示 API，六个平台同步提供。 -| File | Minecraft | Loader | MTR | Java | -| --- | --- | --- | --- | --- | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.21.1-MTR4.1.0-beta.2-neoforge.jar` | 1.21.1 | NeoForge 21.1.x | 4.1.0-beta.2 | 21 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.21.1-MTR4.1.0-beta.2-fabric.jar` | 1.21.1 | Fabric | 4.1.0-beta.2 | 21 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.1-MTR4.0.5-forge.jar` | 1.20.1 | Forge 47.x | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.1-MTR4.0.5-fabric.jar` | 1.20.1 | Fabric | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.4-MTR4.0.5-forge.jar` | 1.20.4 | Forge 49.x | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.4-MTR4.0.5-fabric.jar` | 1.20.4 | Fabric | 4.0.5 | 17 | - -## Validation and known limits / 验证与已知限制 - -Six-target builds, JAR checks, shared unit tests and public Java 17 API consumer checks passed. Development-runtime PIDS checks covered Xaero and JourneyMap on all six targets. This is distinct from a production-JAR/large-modpack acceptance claim; see the manual candidate record for the exact release-binary validation performed. - -**Forge 1.20.4 singleplayer quick-play failed during testing:** Xaero Minimap/WorldMap read a null `serverData` during player join and disconnected before the Overlay snapshot was applied. The root cause remains unconfirmed. The same target passed both-map PIDS checks when connected to a separate local server. Singleplayer quick-play is **not verified as working** in that tested combination. - -六目标构建、产物检查、共享单测和 Java17 API 消费者检查通过；六平台两地图均完成开发运行环境中的基础 PIDS 回归。此结论不等同 production JAR/大型整合包验收，具体发布二进制的验证范围以候选验收记录为准。 - -**Forge 1.20.4 单人 quick-play 存在已知启动问题**：测试时 Xaero 在玩家加入阶段读取空 `serverData`，于 Overlay 快照应用前断开连接，根因尚未确认。该目标连接独立本地服务器后的双地图 PIDS 测试通过；不能据此声称单人启动已通过。 - -Real third-party navigation-provider integration, large-network/multi-viewer performance and cross-machine play have not been validated. No FPS/bandwidth benchmark is claimed. 原生预测覆盖不足会明确显示缺失，不应理解为没有列车或零 ETA；真实第三方导航联动、大网/多观看者性能和跨机器联机仍未实测。 - -[Detailed validation / 完整验证记录](https://github.com/teamCreating/MTR-Map-Overlay/blob/v1.5.3/docs/validation/pids-and-dimmed-1.5.3.md) · [Public API / 公共接口](https://github.com/teamCreating/MTR-Map-Overlay/blob/v1.5.3/docs/api/overlay-api-v1.md) +**新增功能** -## Changes from the previous release / 与上一次 release 的 diff +- **站点点击固定与原生到站预测**：保留原站点、站台和线路信息，默认折叠；点击 **Expand** 后按目的地、线路和站台显示下一班可用服务。直接使用 MTR/TSC 给 PIDS 的数据接口，无预测时明确显示缺失。 +- **两种 PIDS 样式**：默认英式黑底琥珀字，另提供欧式/机场风格。`/mtrmap config pidsStyle british|european` 可即时切换并保存，省略样式参数可查询当前设置。 +- **统一导航与显示接口**：第三方可读取原生站点、线路、停站和路径区段，订阅到站板并控制独立地图视图。待乘区段保持明亮，已走区段和未用线路可分别变暗。**Navigate** 入口支持注册导航服务及多个服务间选择，具体导航由第三方模组接入。 +- **六平台功能同步**：MC 1.21.1 的 NeoForge/Fabric 包对应 MTR 4.1.0-beta.2；MC 1.20.1／1.20.4 的 Forge/Fabric 包对应 MTR 4.0.5。原生站点预测需客户端和服务端安装匹配版本。 -[Full changelog: v1.5.2 → v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2...v1.5.3) +**优化与修复** -[Minecraft 1.20 compatibility diff: v1.5.2-mc1.20 → v1.5.3-mc1.20](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2-mc1.20...v1.5.3-mc1.20) +- 服务端共享原生预测采集和编码，折叠或关闭到站板后释放订阅；通过队列限额、分片节流和公平调度减少重复工作，避免大型目录独占更新。客户端后台解码，不维护第二套行车模拟。 +- 保留旧式站点信息框与 Xaero ROUTES/TRACKS 控件；改善小窗口摘要、长文本悬停、PIDS 列对齐和 ETA 显示，防止面板点击、滚动误触地图拖动或缩放。 +- 修复轨道和玩家箭头覆盖站点面板的问题，保留 Forge 47/49 的网络与输入处理，以及 JourneyMap 5／6 绘制适配。 +- 导航 dimmed 同时作用于线路色、高铁白块、柔化边缘和轨道底衬；后续乘车区段重复使用同一轨道时保持明亮。继续保留全图列车和纯 2D 绘制。 -The refreshed 1.5.2 namespace binaries were built from main `959b7e4da470bf8a1315877a972189cce7c8e776` / compat `54a0acd`; the original release tags were retained. [Diff from the actual refreshed main source / 与1.5.2更新附件实际源码比较](https://github.com/teamCreating/MTR-Map-Overlay/compare/959b7e4da470bf8a1315877a972189cce7c8e776...v1.5.3). +**MC 1.20 Changelog**: [v1.5.2-mc1.20...v1.5.3-mc1.20](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2-mc1.20...v1.5.3-mc1.20) +**Full Changelog**: [v1.5.2...v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2...v1.5.3) --- diff --git a/docs/agents/MESSAGES.md b/docs/agents/MESSAGES.md index d1d2173..5ea4f96 100644 --- a/docs/agents/MESSAGES.md +++ b/docs/agents/MESSAGES.md @@ -1,5 +1,9 @@ # MESSAGES.md — Agent 交流墙（只追加，不改不删） +## [2026-10-26 14:18] Codex-Release — 1.5.3公开说明已按用户样例调整 + +- 2026-10-26 14:18，Codex-Release：按用户提供的1.5.2内容与形式精简1.5.3公开release note，保留中英文新增/优化、MC/MTR说明及末尾双分支diff，并按用户明确要求移除Forge1.20.4限制段。已更新GitHub正文并回读比对；十附件ID/名称/大小/SHA256/时间戳及正式版标记保持。只改说明，未更改tag、版本、二进制或已封存Candidate。 + ## [2026-10-26 14:07] Codex-Release — v1.5.3已正式发布 - 2026-10-26 14:07，Codex-Release：按用户授权发布GitHub [v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/releases/tag/v1.5.3)，正式版/Latest。Candidate 40276489811、Publish 40277036324通过；锁定main 29ab1e17b3496da2899cc0a6740de8afbd5e7faf / compat e272b35534ab726ea0364a2d38aca9ebe007c655，双tag未移动。六JAR和四验证附件全部重新下载，与候选及远端SHA256相同；完整文件名无自定义label。中英文说明标明MC/MTR/loader、功能/优化、Forge49单人失败及上次release diff。见[发布验收](../validation/release-1.5.3.md)。版本继续1.5.3，旧1.5.2附件保持。 diff --git a/docs/agents/STATE.md b/docs/agents/STATE.md index e5f0662..9bc7f44 100644 --- a/docs/agents/STATE.md +++ b/docs/agents/STATE.md @@ -1,7 +1,8 @@ # STATE.md — MC 1.20 兼容分支权威状态 +- 2026-10-26 14:18，Codex-Release：按用户提供的1.5.2内容与形式精简1.5.3公开release note，保留中英文新增/优化、MC/MTR说明及末尾双分支diff，并按用户明确要求移除Forge1.20.4限制段。已更新GitHub正文并回读比对；十附件ID/名称/大小/SHA256/时间戳及正式版标记保持。只改说明，未更改tag、版本、二进制或已封存Candidate。 - 2026-10-26 14:07，Codex-Release：按用户授权发布GitHub [v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/releases/tag/v1.5.3)，正式版/Latest。Candidate 40276489811、Publish 40277036324通过；锁定main 29ab1e17b3496da2899cc0a6740de8afbd5e7faf / compat e272b35534ab726ea0364a2d38aca9ebe007c655，双tag未移动。六JAR和四验证附件全部重新下载，与候选及远端SHA256相同；完整文件名无自定义label。中英文说明标明MC/MTR/loader、功能/优化、Forge49单人失败及上次release diff。见[发布验收](../validation/release-1.5.3.md)。版本继续1.5.3，旧1.5.2附件保持。 -- 最后更新：2026-10-26 14:07，操作者：Codex-Release +- 最后更新：2026-10-26 14:18，操作者：Codex-Release - 2026-10-26 13:32，Codex：补齐Fabric1.21.1和四旧目标的computer-use实机回归，六平台双地图均完成站点折叠/展开、原生ETA和英式/欧式样式检查；各loader滚轮和悬停检查通过。Forge1.20.4单人quick-play遇到Xaero serverData为空而断线，独立本地服务器连接后的双地图通过，单人问题保留待查。未改生产代码，功能源码仍main c1e0314 / compat e041b0a；未发布。详见[验证](../validation/pids-and-dimmed-1.5.3.md)。真实导航provider端到端和大网性能仍未测。 - 分支：`compat/mtr-4.0-mc-1.20`；原基于 main `6afde36`（v1.5.1），现移植 main `df9df96` 最新功能。 - 开发版本：**v1.5.3**（用户指定，禁止自动递增）；mod ID `mtrmap`；包 `io.github.teamcreating.mtrmap`；客户端命令 `/mtrmap`。 diff --git a/docs/agents/TASKS.md b/docs/agents/TASKS.md index e50df92..4bbed72 100644 --- a/docs/agents/TASKS.md +++ b/docs/agents/TASKS.md @@ -7,6 +7,7 @@ ## 进行中 + ### [待领，兼容QA] Forge1.20.4单人quick-play的Xaero初始化失败 - Codex，2026-10-26 13:32：见验证文档的失败日志；独立服双地图PIDS通过，单人启动不算通过，需production/无Overlay对照定位。 @@ -24,6 +25,8 @@ ## 完成 +- [完成] 1.5.3公开发布说明按用户样例精简 — Codex-Release，2026-10-26 14:18，见本条所在提交。GitHub正文与中英文新增/优化、末尾diff已更新；按要求移除Forge49限制段。回读核对十附件身份/哈希/时间戳及正式标记保持。 + - [完成] v1.5.3正式发布 — Codex-Release，2026-10-26 14:07，见本条所在提交。Candidate/Publish通过，六MC/MTR/loader命名JAR及四验证附件重新下载核对SHA256，Latest/双tag/正文diff检查通过；Forge49单人限制已公开，1.5.2未动。 - [完成] 1.5.3四兼容目标双地图基础实机回归 — Codex，2026-10-26 13:32，见本条所在提交。Core4.0.5原生预测、默认折叠/展开、两主题/持久命令、滚轮与悬停通过；Forge49以独立服方式通过，单人Xaero serverData为空的失败保留并待定位。未改生产代码、版本或发布。 diff --git a/docs/releases/v1.5.3.md b/docs/releases/v1.5.3.md index c58b753..fc9a364 100644 --- a/docs/releases/v1.5.3.md +++ b/docs/releases/v1.5.3.md @@ -1,70 +1,37 @@ -Compared with v1.5.2, this release adds native station arrival boards, two PIDS themes and a public API for third-party navigation views. +Compared with v1.5.2, this release adds native station arrival boards, British and European PIDS styles, and a unified map-view API for third-party navigation mods across all six supported builds. -## Added +### Added -- **Pinned station information and native arrivals.** Click a station to keep its original station/platform/route information open. The card starts collapsed; **Expand** shows the next available services by destination, line and platform, using the same MTR/TSC arrival-data interface used for PIDS. Closing or collapsing the board releases its subscription. Missing predictions are displayed explicitly rather than as zero-minute arrivals. -- **British and European/airport PIDS styles.** British black/amber is the default. Use `/mtrmap config pidsStyle british` or `/mtrmap config pidsStyle european` to switch immediately and save the choice. Omit the style argument to query the current setting. -- **A unified navigation/view API.** Third-party mods can read native station/route/stop/path identifiers, resolve route sections, open owned view sessions and subscribe to station boards. They can highlight upcoming sections while independently dimming completed sections and unused lines, including different sections of the same physical rail. The **Navigate** entry supports registered providers and a chooser when several are available. It is disabled when no provider is installed; this release does not include an MTR-Navigation/howtogo-specific adapter. +- **Pinned station information and native arrivals.** Click a station to keep its original station, platform and route information open. The card starts collapsed; **Expand** shows the next available services by destination, line and platform. Predictions come directly from the MTR/TSC data interface used for PIDS, with missing predictions shown explicitly. +- **British and European/airport PIDS styles.** British black/amber is the default. `/mtrmap config pidsStyle british|european` switches the style immediately and saves the choice; omit the style argument to query the current setting. +- **A unified navigation and display API.** External mods can read native stations, routes, stops and path sections, subscribe to arrival boards, and control independent map views. Upcoming sections can remain bright while completed sections and unused lines are dimmed separately. The **Navigate** entry supports registered providers and a chooser when several are available; third-party mods supply the navigation integration. +- **The same features on all six platforms.** NeoForge/Fabric MC 1.21.1 builds target MTR 4.1.0-beta.2; Forge/Fabric MC 1.20.1 and 1.20.4 builds target MTR 4.0.5. Native station arrivals require matching client and server Overlay versions. -## Optimized and fixed +### Optimized and fixed -- Reused native MTR/TSC arrival predictions without adding a client-side transit simulation. Station interests share server collection/encoding, with bounded leases, queues, paced chunks and fair transmission across players and interests. Clients decode in the background and reject stale snapshots. -- Preserved the classic station card and Xaero ROUTES/TRACKS controls. Improved narrow-window summaries, long-text hover details, aligned PIDS columns and ETA readability. Panel scrolling and clicks are intercepted before map zoom/pan actions. -- Fixed rail layers and the player arrow appearing over station panels. Retained separate Forge 47/49 input/network adapters and JourneyMap 5/6 rendering bridges. -- Navigation dimming applies consistently to route colours, high-speed white blocks, feathered edges and physical backing. Overlapping upcoming sections remain bright even when an earlier navigation leg uses the same track. -- All six builds include these features. Whole-map live trains, native XYZ storage and pure 2D rendering remain available; vehicle-hover ETA/next-stop distance is still deferred. +- Shared native arrival collection and encoding on the server, with subscriptions released when boards are collapsed or closed. Bounded queues, paced chunks and fair scheduling reduce repeated work and prevent large catalogues from monopolizing updates. Clients decode snapshots in the background without running another transit simulation. +- Preserved the classic station card and Xaero ROUTES/TRACKS controls. Improved narrow-window summaries, long-text hover details, PIDS column alignment and ETA readability; panel clicks and scrolling no longer trigger map pan or zoom. +- Fixed tracks and the player arrow appearing over station panels. Retained loader-specific Forge 47/49 networking and input handling, plus JourneyMap 5/6 rendering bridges. +- Applied navigation dimming consistently to route colours, high-speed white blocks, soft edges and rail backing. Upcoming sections remain bright when a later navigation leg reuses the same track. Whole-map trains and pure 2D rendering remain available. -## 中文更新说明 +### 中文更新说明 -相较 v1.5.2，新增原生站点到站板、英式/欧式两套 PIDS，以及供第三方导航模组接入的统一地图视图 API。 +相较 v1.5.2，本版新增原生站点到站板、英式与欧式 PIDS，以及供第三方导航模组接入的统一地图显示 API，六个平台同步提供。 -### 新增功能 +**新增功能** -- **站点点击固定与原生到站预测**：保留原站点、站台和线路信息，默认折叠；点击 **Expand** 后按目的地、线路和站台显示下一班可用服务。直接使用 MTR/TSC 给 PIDS 的到站数据接口；无预测明确显示缺失，折叠或关闭后释放订阅。 -- **两种 PIDS 样式**：默认英式黑底琥珀字，可用 `/mtrmap config pidsStyle british|european` 即时切换并保存；不带样式参数可查询当前设置。 -- **统一导航/显示接口**：第三方可读取原生站点、线路、停站序号和路径目录，解析区段并控制独立视图。待乘区段保持明亮，已走区段和未用线路可分别变暗，同一物理轨道也能按区段控制。预留 **Navigate** 入口及多 provider 选择；没有 provider 时禁用。本版未内置特定导航模组的适配器。 +- **站点点击固定与原生到站预测**：保留原站点、站台和线路信息，默认折叠；点击 **Expand** 后按目的地、线路和站台显示下一班可用服务。直接使用 MTR/TSC 给 PIDS 的数据接口，无预测时明确显示缺失。 +- **两种 PIDS 样式**：默认英式黑底琥珀字，另提供欧式/机场风格。`/mtrmap config pidsStyle british|european` 可即时切换并保存，省略样式参数可查询当前设置。 +- **统一导航与显示接口**：第三方可读取原生站点、线路、停站和路径区段，订阅到站板并控制独立地图视图。待乘区段保持明亮，已走区段和未用线路可分别变暗。**Navigate** 入口支持注册导航服务及多个服务间选择，具体导航由第三方模组接入。 +- **六平台功能同步**：MC 1.21.1 的 NeoForge/Fabric 包对应 MTR 4.1.0-beta.2；MC 1.20.1／1.20.4 的 Forge/Fabric 包对应 MTR 4.0.5。原生站点预测需客户端和服务端安装匹配版本。 -### 优化与修复 +**优化与修复** -- 服务端共享原生预测采集和编码，增加租约、容量限制、后台队列、分片节流与玩家/订阅轮转；客户端后台解码并拒绝旧快照，不维护第二套行车模拟。 -- 恢复旧式站点信息框与 Xaero ROUTES/TRACKS 控件；改善小窗口摘要、长文本悬停、表格列对齐和 ETA 显示，防止面板操作误触地图缩放/拖动。 -- 修复轨道和玩家箭头覆盖站点面板的问题，保留 Forge 47/49 和 JourneyMap 5/6 的独立兼容处理。 -- 导航 dimmed 同时作用于线路色、高铁白块、边缘及物理底衬；后续乘车区段重复使用同一轨道时保持明亮。 -- 六个平台同步提供本次功能；继续保留全图列车、真实 XYZ 和纯 2D 绘制。列车悬停 ETA/下一站距离仍暂缓。 +- 服务端共享原生预测采集和编码，折叠或关闭到站板后释放订阅；通过队列限额、分片节流和公平调度减少重复工作，避免大型目录独占更新。客户端后台解码，不维护第二套行车模拟。 +- 保留旧式站点信息框与 Xaero ROUTES/TRACKS 控件；改善小窗口摘要、长文本悬停、PIDS 列对齐和 ETA 显示，防止面板点击、滚动误触地图拖动或缩放。 +- 修复轨道和玩家箭头覆盖站点面板的问题，保留 Forge 47/49 的网络与输入处理，以及 JourneyMap 5／6 绘制适配。 +- 导航 dimmed 同时作用于线路色、高铁白块、柔化边缘和轨道底衬；后续乘车区段重复使用同一轨道时保持明亮。继续保留全图列车和纯 2D 绘制。 -## Choose the matching file / 下载环境 +**MC 1.20 Changelog**: [v1.5.2-mc1.20...v1.5.3-mc1.20](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2-mc1.20...v1.5.3-mc1.20) -Install **one** mod JAR matching the exact Minecraft version, MTR version and loader. Native station arrivals and whole-map trains require matching client/server Overlay versions; client-only installations cannot provide the server snapshot service. - -按游戏版本、MTR 版本和加载器选择**一个** JAR。原生站点预测及全图列车需客户端和服务端安装匹配版本；仅客户端安装无法提供服务端快照服务。 - -| File | Minecraft | Loader | MTR | Java | -| --- | --- | --- | --- | --- | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.21.1-MTR4.1.0-beta.2-neoforge.jar` | 1.21.1 | NeoForge 21.1.x | 4.1.0-beta.2 | 21 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.21.1-MTR4.1.0-beta.2-fabric.jar` | 1.21.1 | Fabric | 4.1.0-beta.2 | 21 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.1-MTR4.0.5-forge.jar` | 1.20.1 | Forge 47.x | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.1-MTR4.0.5-fabric.jar` | 1.20.1 | Fabric | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.4-MTR4.0.5-forge.jar` | 1.20.4 | Forge 49.x | 4.0.5 | 17 | -| `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.4-MTR4.0.5-fabric.jar` | 1.20.4 | Fabric | 4.0.5 | 17 | - -## Validation and known limits / 验证与已知限制 - -Six-target builds, JAR checks, shared unit tests and public Java 17 API consumer checks passed. Development-runtime PIDS checks covered Xaero and JourneyMap on all six targets. This is distinct from a production-JAR/large-modpack acceptance claim; see the manual candidate record for the exact release-binary validation performed. - -**Forge 1.20.4 singleplayer quick-play failed during testing:** Xaero Minimap/WorldMap read a null `serverData` during player join and disconnected before the Overlay snapshot was applied. The root cause remains unconfirmed. The same target passed both-map PIDS checks when connected to a separate local server. Singleplayer quick-play is **not verified as working** in that tested combination. - -六目标构建、产物检查、共享单测和 Java17 API 消费者检查通过；六平台两地图均完成开发运行环境中的基础 PIDS 回归。此结论不等同 production JAR/大型整合包验收，具体发布二进制的验证范围以候选验收记录为准。 - -**Forge 1.20.4 单人 quick-play 存在已知启动问题**：测试时 Xaero 在玩家加入阶段读取空 `serverData`，于 Overlay 快照应用前断开连接，根因尚未确认。该目标连接独立本地服务器后的双地图 PIDS 测试通过；不能据此声称单人启动已通过。 - -Real third-party navigation-provider integration, large-network/multi-viewer performance and cross-machine play have not been validated. No FPS/bandwidth benchmark is claimed. 原生预测覆盖不足会明确显示缺失，不应理解为没有列车或零 ETA；真实第三方导航联动、大网/多观看者性能和跨机器联机仍未实测。 - -[Detailed validation / 完整验证记录](https://github.com/teamCreating/MTR-Map-Overlay/blob/v1.5.3/docs/validation/pids-and-dimmed-1.5.3.md) · [Public API / 公共接口](https://github.com/teamCreating/MTR-Map-Overlay/blob/v1.5.3/docs/api/overlay-api-v1.md) - -## Changes from the previous release / 与上一次 release 的 diff - -[Full changelog: v1.5.2 → v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2...v1.5.3) - -[Minecraft 1.20 compatibility diff: v1.5.2-mc1.20 → v1.5.3-mc1.20](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2-mc1.20...v1.5.3-mc1.20) - -The refreshed 1.5.2 namespace binaries were built from main `959b7e4da470bf8a1315877a972189cce7c8e776` / compat `54a0acd`; the original release tags were retained. [Diff from the actual refreshed main source / 与1.5.2更新附件实际源码比较](https://github.com/teamCreating/MTR-Map-Overlay/compare/959b7e4da470bf8a1315877a972189cce7c8e776...v1.5.3). +**Full Changelog**: [v1.5.2...v1.5.3](https://github.com/teamCreating/MTR-Map-Overlay/compare/v1.5.2...v1.5.3) diff --git a/docs/validation/release-1.5.3.md b/docs/validation/release-1.5.3.md index e714c4b..8d89f92 100644 --- a/docs/validation/release-1.5.3.md +++ b/docs/validation/release-1.5.3.md @@ -30,3 +30,7 @@ Codex-Release，2026-10-26 14:07（Asia/Taipei）。用户明确授权发布； | `CRTools-MTR-Map-Overlay-1.5.3-MC1.20.4-MTR4.0.5-fabric.jar` | `f4893bdadc4c316f3f18d27579c25be35d0e71fc87d64c013d6464d611017898` | 已知Forge1.20.4单人quick-play在Xaero初始化阶段断线；独立服双地图通过，根因未确认。真实导航provider、production启动器、大网/多玩家及跨机器联机仍未实测。见[完整PIDS验证](pids-and-dimmed-1.5.3.md)。 + +## 发布说明后续编辑 + +2026-10-26 14:18，Codex-Release：按用户提供的1.5.2内容与形式精简1.5.3公开release note，保留中英文新增/优化、MC/MTR说明及末尾双分支diff，并按用户明确要求移除Forge1.20.4限制段。已更新GitHub正文并回读比对；十附件ID/名称/大小/SHA256/时间戳及正式版标记保持。只改说明，未更改tag、版本、二进制或已封存Candidate。原发布流程的说明/验收记录仍保留于封存候选与工作流，最新公开正文以Release页面为准。