SkyRail Suite 4.0.7 — Dispatcher MA Control

SkyRail Suite 4.0.7：停车改道与调度撤销 MA

配套版本：SkyTrainFolia 4.0.7、STCS 4.0.5、STA 2.1.3、SkyPCC 2.0.2。单个 STF JAR 继续支持 Shiroha 26.2 和 26.3。

停车后由调度直接转岔

原有 MA 路径锁仍然有效。现在，若某道岔只被一列已停稳的手动列车 MA 预约，且道岔没有车身占用、位置不确定或其他冲突，调度员可以直接点“转换道岔”。司机不必先输入 release。

后台按顺序执行：

1. 标记道岔正在处理，暂停该列车的 MA 重算，保留旧预约。
2. 等待车端在列车运行 tick 中确认全列停稳、禁止牵引并清除旧车端授权。此阶段为 WITHDRAWING_MA。
3. 确认后释放前方 MA 预约，重新检查定位、停稳、占用、图版本和道岔状态，再执行转换。
4. 转换确认完成后重算原 MA 请求，结束临时停车保持。司机仍需正常操作手柄，不会自动加速。

如果确认期间列车移动、遥测过期、车体接近道岔、出现其他预约或转换失败，则拒绝或中止。失败后不自动恢复原进路请求；核实情况后重新申请 MA。多个 MA 持有者、自动列车以及未确认的停车状态不执行自动解锁。旧版 STF 没有车端确认接口时继续拒绝 MA 冲突。

ma.lock-distance-meters 仍默认 150 米，未通过缩小距离或取消占用检查来实现该功能。

撤销所选列车 MA → TR

• 网页 PCC：选择列车，在详情区点击“撤销 MA → TR”，核对目标并输入网页控制令牌确认。
• 支持手动列车在运行或停车状态下撤销。车端确认后进入 TR、禁止牵引并施加制动；不是只删服务端的 MA。
• 运行中撤销后，旧前方预约和道岔保护继续保留，直到确认全列停稳。车身占用不因撤销而清除。
• 无法联系车端、列车未加载或确认超时时，返回未确认／拒绝，不能将按钮点击成功当作列车已经制动。
• 司机恢复：停稳 → /stcs ma ack 进入 PT → /stcs ma release → 重新申请 MA。不能通过直接 demand 绕过调度停车保持。

调度员主动撤销在影子通道下也会执行 TR 停车保持；这与影子 MA 本身仅观察的日常行为不同。自动列车不在本次手动列控功能范围内，会被拒绝。

网页采用相同请求 ID 重试，服务端保留有限数量的请求结果以避免重复执行。网页继续要求开启控制功能和有效 Bearer token；STA Remote 接口使用 TLS 管理员鉴权及写请求限流。运行事件记录 DISPATCHER_REVOKED 和车端制动事件，保留时间、目标与来源。

升级

停服并备份后，同时替换已安装的四个插件为本页列出的版本，避免只升级按钮而缺少车端／STCS 接口。删除旧版本 JAR 后再放入新 JAR，保留插件配置、RailGraph、占用账本、证书和令牌。沿用原服务端启动方式。

网页强制刷新以加载新界面。本次 GitHub 发布仅包含四个服务端插件，Python 调度台更新及配置工具暂不发布。

验证与限制

本地最终构建：Shiroha 26.2、26.3 各 82 个 Java 测试入口通过；网页 294 个四语言词条检查、线路样式测试和桌面／移动尺寸浏览器测试通过。轨道图重建后的撤销保护和事件通知失败另在两版依赖下完成专项回归。

隔离测试覆盖停车改道的车端确认、确认前不解锁、确认期间移动拒绝、重复请求、主动 TR 在停车／运行两种状态下生效、过期请求拒绝、运行中保留预约及停稳后保留车身占用。网页浏览器测试覆盖实际按钮、鉴权头、固定请求 ID 轮询和令牌清除。

该版本尚需测试服实车验收，尤其是跨区域列车、密集站场、断线和转岔失败场景。测试时分别验证停车改道、运行中 revoke、停车 revoke、TR 恢复流程，核对道岔实际方向及占用账本；不要在未确认撤销结果时手工清除占用或强制转岔。

SkyRail Suite 4.0.6 — Shiroha 26.2/26.3 (Pre-release)

SkyRail Suite v4.0.6 (pre-release)

Experimental pre-release. Isolated compilation and Java tests pass on Shiroha 26.2 and 26.3. Live-server acceptance of this candidate is still pending.

Release set: SkyTrainFolia 4.0.6 / STCS 4.0.4 / SkyworldTrainAPI 2.1.1 / SkyPCC 2.0.1. Java 25 is required. The same SkyTrainFolia JAR contains both display packet adapters and selects the matching one at runtime.

Changes since suite v4.0.2

• SkyTrainFolia 4.0.6 adapts train display entity removal, relative movement and absolute position packets for Shiroha 26.3 while preserving the 26.2 path. Packet handling remains isolated from train motion and higher-level control code.
• SkyTrainFolia 4.0.4–4.0.5 adds localized, state-gated driver hints and an editable driver-guide.yml phrase library.
• STCS 4.0.4 and SkyTrainFolia add an attended recovery path for a failed shadow occupancy ledger. STCS also narrows SR graph-gap checks to the directed route actually used.
• SkyworldTrainAPI 2.1.1 includes the optional TLS remote dispatcher service and updated desktop dispatch map. The remote endpoint remains disabled by default.
• SkyPCC 2.0.1 accepts authenticated remote switch and SR approval requests when explicitly enabled; its default bind address remains 127.0.0.1.

Validation

• Shiroha 26.2: all four plugins compile; 80 Java test entry points and the packaged STF protocol test pass.
• Shiroha 26.3: all four plugins compile; 80 Java test entry points and the packaged STF protocol test pass.
• Real-client driving, full-consist visuals, region-boundary movement, cab sidebar and lever redstone output still require test-server acceptance before production deployment.

Install

Stop the server and back up the world, plugins/, RailGraph and occupancy ledgers. Replace the installed JARs with the four matching assets below; remove older copies of the same plugins. Use this one SkyTrainFolia JAR on either Shiroha 26.2 or 26.3. Restart fully and verify plugin startup before driving. Do not delete retained occupancy data as an upgrade step. SkyTrainFolia can still run alone; Enforced needs STA and STCS.

The attached SHA256.json lists checksums for the four JARs. Server cores and third-party libraries are not bundled.

Details: dual-version adaptation, driver guide, ledger reset, STA dispatcher, SkyPCC authorization.

SkyRail Suite 4.0.2 - MA Recovery and Low-Speed Warnings (Pre-release)

SkyRail Suite v4.0.2 (pre-release)

Experimental pre-release. Live-server acceptance of these changes is pending.

Release set: SkyTrainFolia 4.0.2 / STCS 4.0.2 / SkyworldTrainAPI 2.0.0 / SkyPCC 2.0.0. Minecraft/Folia 26.2 baseline, Java 25. STA protocol and PCC version are unchanged.

Changes

• Near-limit audio now has a low-speed band selected by the current ATP limit. At limits <=40 km/h, including the default SH ceiling, warn at limit minus 5 km/h and clear at/below limit minus 8 km/h. At a 40 km/h limit: start at 35, clear at 32. Normal-band defaults for new installs are 15 / 18 km/h; existing normal-band settings remain unchanged. Overspeed priority and ATP brake thresholds are unchanged.
• Configure the low-speed band in STF under shadow-atp.warning: low-speed-limit-kmh: 40, low-speed-enter-gap-kmh: 5, low-speed-clear-gap-kmh: 8.
• STCS retries temporary Windows occupancy-ledger replacement denial up to five attempts with 185 ms total backoff. Persistent failures still stop allocation without clearing retained occupancy.
• New /stcs admin ma restart command (stcs.admin, console supported) attempts recovery from an MA-service I/O failure. It checks source availability, requires fresh stationary reports for outstanding executable authorities, backs up the committed ledger and pending snapshot, and verifies a real write. Drivers must demand MA again. It does not release brakes, change the ATP channel or bypass unknown infrastructure. Non-I/O runtime faults require investigation/server restart.
• Updated the Chinese, English, Dutch, French and Japanese manuals and the Chinese/English/French/Japanese driver guides. The classical Japanese companion is also updated.

Installation and Limits

Validation: all four plugins built; 75 Java test entry points passed, as did PCC edge-line and four-language resource tests and Markdown local-link/fence checks. The local JDK emitted dependency-archive close/access diagnostics while returning success; this is not a clean warning-free build or live-server acceptance. SHA256.json lists the attached JAR checksums.

Stop the server and back up plugin data, including RailGraph, occupancy ledgers and pending .tmp files. Replace STF and STCS; STA/SkyPCC remain at 2.0.0. Do not leave duplicate old/new JARs installed. Restart fully to load the new binaries. For later STF configuration changes, stop all trains before /st reload; it revokes driving control and hotbar mode. Existing normal-band warning values are preserved: explicitly set enter-gap-kmh: 15 and clear-gap-kmh: 18 if desired.

This remains an experimental game system, not certified ATP/interlocking or ETCS SUBSET-026 compliance. Manual-train protection does not apply to STF's built-in sign-driven pseudo-ATO trains. Unknown is not clear. An unconfirmed remote point conversion must not be treated as confirmed; that separate issue is not fixed in this release.

中文说明

预发布，尚待服务器验收。 配套版本为 STF/STCS 4.0.2、STA/SkyPCC 2.0.0；Minecraft/Folia 26.2、Java 25，协议不变。

四模块构建完成，75 个 Java 测试入口、PCC 线路归属与四语言资源测试、Markdown 本地链接及代码块检查通过。本机 JDK 关闭依赖 JAR 时仍有访问诊断但返回成功；不声称无警告构建或实服验收通过。附件校验值见 SHA256.json。

• 低速预警由当前 ATP 限速选档：≤40 km/h 时提前 5 km/h 报警、低于限速 8 km/h 及以下解除；40 限速对应 35 开始、32 解除。普通档新安装默认 15 / 18，已有配置保留。超速优先级、制动逻辑不变。
• STCS 增加 Windows 账本替换有限重试与 /stcs admin ma restart。恢复保留占用并备份账本，需要有效数据源以及旧可执行许可对应列车的新鲜停稳报告。恢复后重新申请 MA，不自动缓解制动；持续故障保持停用。
• 各语言 README 与中英法日司机手册已同步。更新二进制需停服、备份后替换 STF/STCS 并完整重启；不要删除占用数据。后续 /st reload 前应停稳所有列车，重载会收回驾驶权和 hotbar。
• 本版没有修复道岔实际写入成功但返回 UNCONFIRMED 的确认问题，不应据此将未确认当作成功。仍非真实铁路安全设备或标准认证实现，手动列车状态机不适用于内置伪 ATO。

SkyRail Suite 4.0.0 - Experimental M3 (Pre-release)

SkyRail Suite 4.0.0: Experimental M3 Manual-Train Protection

Pre-release. Automated checks passed; the latest fixes have not completed another live-server acceptance run. This release is experimental Minecraft software, not certified ATP, interlocking or an ETCS-compliant implementation.

Components

Plugin	Version
SkyTrainFolia	4.0.0
STCS	4.0.0
SkyworldTrainAPI	2.0.0
SkyPCC	2.0.0

Changes

• Adds manual-train operating modes SB, FS, SH, SR, TR and PT, with a separate administrator-controlled Enforced channel. STF's built-in sign-driven pseudo-ATO trains remain outside this state machine.
• Adds STA v6 operational permissions, onboard speed/EoA supervision, retained last-confirmed EoA within the validated session, Trip acknowledgement and authenticated PCC SR approval. Shadow MA remains observational.
• Corrects SH/SR speed-ceiling braking, near-limit/overspeed warnings in Enforced, ATP B7/EB feedback and localized TR messages and cues.
• Separates SR target reachability from the rolling MA window: default target search is 5000 m, while each local grant is capped at 120 m. Unknown points, graph gaps, occupancy uncertainty and resource conflicts still restrict authority.
• Fixes driver/hotbar revocation and consist geometry retention during STF reload. Adds configurable continuous warning sounds and intervention cues.
• Updates the multilingual README editions and Chinese, English, French and Japanese driver manuals, including introductory MA/EoA/ATP terminology.

Installation and Validation

Stop the server, back up plugin data, then replace the installed suite components together. Retain RailGraph and occupancy ledgers; do not mix old and new binaries. Hard-refresh PCC after updating. STF can still run standalone, but Enforced requires STA and STCS. Enforced is explicitly enabled on a stopped manual train with /stcs admin enforce true; false returns to RECOVERING brake hold.

The attached four JARs were built against the existing Minecraft/Folia 26.2 baseline with Java 25. SHA256.json contains their checksums. Validation already completed: 73 Java test entry points, PCC edge-line and four-language resource tests, and documentation file-link/fence checks. This publication does not claim successful live-server acceptance of the latest changes.

中文说明

本次为预发布。 已完成自动检查，但最近的修复未再进行一轮服务器验收。配套版本为 STF/STCS 4.0.0、STA/SkyPCC 2.0.0。

• 新增仅适用于手动列车的 SB/FS/SH/SR/TR/PT 模式，以及管理员显式启用的 Enforced 制动监督；内置牌子控车伪 ATO 不进入此状态机。
• 新增 STA v6 可执行许可、车载速度/EoA 监督、有效会话内最后确认 EoA 的保持、Trip 确认和 PCC SR 审批。影子 MA 仍只读。
• 修正 SH/SR 模式限速制动、强制保护通道的接近限速/超速警报、ATP B7/EB 显示和 TR 消息与音效。
• SR 目标可达性与滚动 MA 窗口分离，默认目标搜索 5000 m、单次许可 120 m；未知状态、占用和资源冲突仍限制授权。
• 修复 STF reload 时驾驶权与热键栏撤销、编组几何保持，并同步各语言 README 和中英法日司机术语入门。

停服备份后一起替换已安装的组件，保留轨道图与占用账本，刷新 PCC 缓存。附件基于 Minecraft/Folia 26.2、Java 25 构建。73 个 Java 测试入口及 PCC 相关检查已通过；这不等于服务器验收通过，也不代表真实铁路 ATP、联锁或 ETCS 标准认证。

SkyRail Suite 3.0.0 — STA v5

SkyRail Suite 3.0.0: STA v5 Protocol Transition

Matching Components / 配套组件

Plugin	Version
SkyTrainFolia	3.0.0
STCS	3.0.0
SkyworldTrainAPI	1.0.0
SkyPCC	1.0.0

Breaking Changes / 非兼容变更

• Telemetry, graph, driver desk, authority and switch service contracts move from v2/v4 to net.skyworld.sta.api.v5. External Java consumers must rebuild.
• PCC HTTP/SSE routes move to /api/v5/. Old routes and old message versions are not supported. Refresh the browser after upgrading.
• Conceptual numbering: allocated shadow MA Message 1003 / Packet 1015; telemetry Message 1136. Private lifecycle removal, graph reports and waiting/inactive authority status use Message 2001, 2002 and 2003 respectively.
• Message and Packet namespaces are independent. These identifiers are an homage, not ETCS encoding or a SUBSET-026 compliance claim. Train removal is not proof of track clearance.

遥测、图、驾驶台、MA 和道岔契约统一至 v5，PCC 改用 /api/v5/。旧插件组合、旧路由和旧消息版本不兼容；第三方 Java 扩展需重新编译。编号仅为概念致敬，不代表 ETCS 兼容。删除列车不等于占用出清。

Diagnostics / 诊断

/stcs integrity [train-name|uuid] (stcs.admin) reports member distribution and inferred node passages. It is read-only and in-memory: it neither clears occupancy nor proves a complete axle-counter event chain. A restart resets the diagnostic baseline, not the durable ledger. Stationary trains have no occupancy-expiry timer.

新增管理员节点完整度诊断，显示成员跨边分布与推断通过。它不清占用、不批准 MA，不是完整虚拟计轴器；重启不清账本，停车不触发占用超时释放。

Upgrade / 升级

1. Stop the server and back up JARs, configuration, RailGraph and occupancy ledgers.
2. Replace the installed suite components with the four matching versions above. Remove superseded JARs from the plugin directory. STF can still be installed alone without STA.
3. Keep existing RailGraph and occupancy data; their on-disk schemas are unchanged by this release.
4. Restart fully, refresh PCC and update external clients to v5. Test driver acquisition, MA demand/release, retained occupancy and turnout requests before production use.

停服备份，配套替换已安装组件，不混装旧 JAR。保留配置、轨道图和占用账本，完整重启并刷新 PCC。先在测试服验证驾驶权、MA 申请/释放、重启保留占用及道岔操作。不要删除账本来完成升级。

Validation and Limits / 验证与边界

• Four JARs built; 63 Java test entry points passed, including standalone STF reflection/loading and STA adapter integration.
• PCC JavaScript tests and four-language/shadow browser regressions passed, including old-snapshot and wrong-MA-ID rejection.
• This release still requires live-server validation. It prepares interfaces for M3; it does not complete M3.
• MA/EoA and onboard speed curves remain experimental and shadow-only. No automatic ATP braking, FS activation or certified interlocking. Unknown/unloaded infrastructure must not be treated as clear.

已通过本地构建及回归，仍需实服验收。M3 尚未完成，不开放 FS 或自动 ATP 制动，不声称铁路安全认证。

SkyTrainFolia-2.1.4

Remove STA dependency for Modrinth release.

SkyTrainFolia-2.1.3

Fix some pseudo-ATO Train behaviors.

STCS-2.2.0-Alpha.2

Fix some bug on mileage. Just replace the Alpha1.

SkyRail Suite 0.1.0 Alpha 1

SkyRail Suite 首个公开 Alpha 版本。

包含 SkyTrainFolia、STCS、SkyworldTrainAPI 和 SkyPCC。

需要 Java 25。已在 Skyworld 使用的 Minecraft 26.2 Shiroha/Folia 服务端构建版本上完成测试。

目前，Movement Authority（行车许可）仅用于影子测试（Shadow Testing）。ATP 速度监督和 EoA（行车许可终点）制动监督功能尚未启用。

部署前请备份服务器并充分测试。安装或更新插件前，请先停止服务器。

代码采用 MIT 许可证授权。允许分发软件包中附带的 SkyPCC 吉祥物美术素材，但这并不意味着该美术素材同样适用代码所采用的 MIT 许可证。

First public alpha release of SkyRail Suite.

Includes SkyTrainFolia, STCS, SkyworldTrainAPI and SkyPCC.

Requires Java 25. Tested with the Minecraft 26.2 Shiroha/Folia server build used by Skyworld.

Movement Authorities are currently for shadow testing only. ATP speed and EoA braking supervision are not active.

Back up your server and test before deployment. Stop the server before installing or updating the plugins.

Code is MIT-licensed. Distribution of the bundled SkyPCC mascot artwork is permitted; this does not place the artwork under the code's MIT license.