?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
SkyTrainFolia

SkyTrainFolia

Folia-native railway plugin for train operation, manual driving, physical turnouts, and sign-driven automatic station operation.

7downloads
0followers
7downloads
0followers

Compatibility

Minecraft: Java Edition

26.3
26.2

Platforms

Links

View source

Tags

Creators

Details

Licensed MIT
Published 2 days ago
Updated 2 days ago

SkyRail Suite & SkyTrainFolia

SkyRail Logo / ETCS Stop Marker

SkyRail Suite is a modular, Folia-native railway simulation, train operation, shadow train control, and centralized dispatching suite for Minecraft.
SkyRail Suite 是专为现代 Minecraft 多区域并行服务端（Folia）打造的模块化列车运行、线路拓扑、影子列控与集中调度套件。

SkyTrainFolia (STF) is the core train-operation and physics engine of the suite, supporting standalone operation as well as full integration into the SkyRail control environment.
SkyTrainFolia（STF） 是该套件的核心列车运行与物理动力学引擎，既支持作为独立插件运行，也可接入完整的 SkyRail 控制体系。

Overview & Philosophy / 项目概述与设计初衷

Traditional single-threaded Minecraft railway plugins frequently suffer from region-thread assertion errors, data corruption, and entity clipping when long train consists cross chunk and region boundaries in Folia. Furthermore, conventional server railways have historically relied on rigid, ten-year-old sign collision and fixed redstone blocks.

传统的单线程 Minecraft 铁路插件在 Folia 分布式区域线程架构下，一旦长编组跨越 Region 边界，极易引发线程断言崩溃、数据损坏与实体穿模。此外，传统服务器铁路长期依赖陈旧的红石与木牌碰撞固定闭塞体系。

SkyRail Suite decouples vehicle dynamics simulation from ground signaling and interlocking. Drawing inspiration from European ETCS Level 2 and modern urban rail CBTC standards, it introduces industrial-grade engineering concepts to the Minecraft sandbox: Newtonian dynamics, Movement Authority (MA/EoA), and the strict separation of control and safety protection.

SkyRail Suite 将车载动力学仿真与地面信号控制深度解耦。设计参考欧洲 ETCS Level 2 与现代城市轨道交通 CBTC 规范，将严谨的工业工程理念引入 Minecraft 沙盒：牛顿动力学数值积分、连续移动授权（Movement Authority, MA/EoA）、以及控制与保护严格分离。

A train depot and a formation of carts, ready for departure.

System Architecture / 核心系统架构

The suite adopts a microkernel, decoupled architecture consisting of four cooperative components:
套件采用解耦的微内核设计，由四个协同运行的核心组件构成：

Minecraft Players / Minecarts / Rails / Redstone
                 │
  [STF]  Physics Dynamics, Regional Execution & HMI Cab
                 │
         (Immutable Data Snapshots)
                 │
  [STA]  Unified Contracts, Telemetry & Event Bus
                 │
  [STCS] Directed RailGraph, Occupancy Ledger & MA Computation
                 │
             (Real-time SSE Streams)
                 │
[SkyPCC] Browser Web Dispatching Desk & Turnout Authorization

1. SkyTrainFolia (STF)

  • Role: Physical dynamics engine and onboard controller.
  • Features: Takes over minecart consists, runs Newtonian acceleration/braking integration, synchronizes smooth display packets, renders multilingual cab HUDs, controls physical turnout rails, and executes experimental ATP braking.
  • 角色： 实体物理动力学引擎与车载控制器。
  • 功能： 接管矿车编组、牛顿力学数值积分加减速、平滑显示同步、多语言驾驶室 HUD、实体铁轨几何道岔控制及实验性 ATP 制动执行。

2. Skyworld Train Control System (STCS)

  • Role: Ground brain and supervisory control centre.
  • Features: Manages whole-world directed RailGraph topology routing, maintains a pessimistic space-grid occupancy ledger, and calculates continuous Movement Authority (MA) curves similar to moving-block signaling.
  • 角色： 地面控制大脑与监控中心。
  • 功能： 负责全图有向 RailGraph 拓扑寻径、维护空间物理网格悲观占用保留账本、以及类似移动闭塞的连续行车许可（MA）演算与下发。

3. SkyworldTrainAPI (STA)

  • Role: Unified contract bus and service layer.
  • Features: Provides shared APIs, event contracts, and telemetry feeds. Ensures thread safety across Folia regions by passing immutable data snapshots, preventing race conditions and thread deadlocks.
  • 角色： 统一契约总线与服务层。
  • 功能： 提供组件间共享 API、事件契约与遥测接口。通过传递不可变数据快照隔离多线程，从根本上杜绝跨线程死锁与指针穿透。

4. SkyPCC (Poste de Commande Centralisée)

  • Role: Web centralized dispatching desk.
  • Features: Zero client-side mods required. Operates directly in standard web browsers to provide real-time train tracking, balise and turnout monitoring, route establishment, and token-based remote turnout authorization.
  • 角色： 现代化 Web 集中调度大屏。
  • 功能： 客户端零 Mod 依赖。支持原生浏览器访问，提供全线列车实时追踪、应答器与道岔监视、进路办理以及基于安全令牌的道岔远程控制。

SkyPCC Interface

Key Features / 核心功能亮点

1. Folia Native Concurrency / 原生 Folia 多区域并发保障

  • Deeply adapted to the Folia regional entity scheduler.
  • Vehicle motion integration and packet broadcasting are strictly contained within their respective region threads. Consists transition smoothly across multi-region boundaries, fully leveraging multi-core server performance. Dynamic SPI architecture ensures compatibility across Shiroha and Folia 26.2 / 26.3 platforms.
  • 深度适配 Folia 区域实体调度器。各节车厢的位移积分与发包严格收敛在所属的 Region 线程中，长编组列车跨越多个区域时平稳过渡，全面释放多核算力。适配层采用动态 SPI 架构，同时兼容 Shiroha 与 Folia 26.2 / 26.3 版本。

2. Moving Block & MA Calculations / 工业级列控：移动闭塞与 MA 演算

  • Replaces rudimentary block-occupancy signs with dynamic, topological safety distance calculations.
  • Computes real-time dynamic braking intervention curves and provides comprehensive onboard state machine transitions:
    • SB (Standby / 待命)
    • FS (Full Supervision / 完全监控)
    • SH (Shunting / 调车)
    • SR (Staff Responsible / 目视行车)
    • TR (Trip / 冒进停车)
    • PT (Post Trip / 冒后恢复)
  • 告别传统木牌占道碰撞。沿有向拓扑路径为列车动态计算前方安全余量与制动干预曲线，并提供完整的车载列控状态机转换（SB / FS / SH / SR / TR / PT）。

3. Pessimistic Safety Principle / 悲观安全哲学：未知绝非空闲

  • Built upon an "evidence-retained model".
  • If a train experiences cross-region latency, chunks unload, or a turnout switch confirmation is unverified, the control system refuses to assume the track ahead is clear. Occupancies are retained in the ledger to block downstream authorities, preventing train collisions and overlap caused by server stutter.
  • 运行在“证据保留模型”下。当列车发生跨区网络延迟、区块卸载或道岔状态未经验证时，控制层绝不假定前方空闲，而是保留物理格占用以阻断后续移动授权，防止因服务器卡顿造成列车重叠与穿模。

4. Cab Ergonomics & Driving Control / 驾驶工效学与操控系统

  • Hotbar Traction Controller: Hotbar slots 1–9 simulate a driver cab master controller, offering 4 power notches (P1–P4), 7 service brake notches (B1–B7), and emergency braking (EB).
  • Multilingual Driver HMI: Built-in BossBar and Scoreboard HUDs display live speed limits, Movement Authority credit, and brake intervention curves.
  • Audio Feedback: Authentic vanilla sound cues for MA updates, staged overspeed alerts, and hysteresis protection.
  • 快捷栏物理手柄： 快捷栏 1–9 槽位模拟手柄操作，提供 4 级牵引（P1–P4）、7 级常用制动（B1–B7）及紧急制动（EB）。
  • 多语言车载 HMI： 整合 BossBar 与计分板界面，实时显示动态限速、MA 剩余行车许可距离与干预曲线。
  • 声效反馈： 基于原版音效实现 MA 变动提示、超速分级预警与滞回保护。

Driver Interface

5. Physical Turnout Switching / 实体铁轨几何道岔

  • Controls physical turnouts constructed from actual in-game rails.
  • Switches real in-world rail geometries rather than treating turnouts solely as abstract route variables. Supports local manual switching, approach-based auto-alignment, and local interlocking train locks.
  • 直接控制由游戏铁轨构成的实体道岔。实际改变游戏世界中的轨道几何形态，而不仅是后台抽象进路。支持本地道岔操作、列车接近时预开通以及局部列车锁定保护。

6. Sign-Driven Automation / 牌子驱动的轻量自动化

  • Supports lightweight, sign-based automation for station operations:
    • Train spawning and removal
    • Station detection and approach
    • Deceleration and precision stopping
    • Station dwell timing and automatic departure
  • Note: Designed as a lightweight automation system for Minecraft, not a full real-world ATO system.
  • 支持轻量化牌子自动运行机制：列车生成与销毁、车站识别与接近、自动减速与精准停车、停站延时与自动发车。（注：此机制为沙盒环境轻量自动化，非完整现实 ATO 系统）。

7. Zero Client Mod & 4-Language Support / 零客户端 Mod 与四语言支持

  • Both the in-game interface and the SkyPCC dispatcher web desk natively support:
    • English
    • 中文
    • Français
    • 日本語
  • Players can drive trains and dispatchers can monitor traffic through standard browsers without installing Forge, Fabric, or custom client mods.
  • 游戏内界面与 SkyPCC 调度网页原生支持中、英、法、日四国语言。客户端无需安装任何 Mod，浏览器直接接入全线调度。

Quick Start Guide / 快速上手指南

For Detailed information, please goto the GitHub Page / 详细信息请参见GitHub仓库。

1. Train Consist Creation / 编组创建

Place minecarts on a straight test track, then run (Admin):
在平直测试轨道上放置矿车后，管理员执行：

/st scan 6                         # Search for connectable minecarts within 6 blocks / 搜索附近6格内的矿车
/st create demo 6                  # Group carts into a train named "demo" / 将矿车编入名为 demo 的列车
/st property demo mode manual      # Set operating mode to manual / 设定为手动驾驶模式

2. Driving Controls / 司机接管与驾驶

Sit in the driver seat and execute:
坐进车内后，执行以下指令取得驾驶权：

/st drive                          # Acquire driving control (Leaving seat triggers EB) / 取得驾驶权（离车自动EB）
/st forward                        # Set reverser to forward (/st backward for reverse) / 换向器向前（/st backward反向）

Drive using commands or hotbar controller:
随后即可使用指令或快捷栏手柄进行驾驶：

  • /p1 – /p4: Traction notches / 牵引级位
  • /b1 – /b7: Service brake notches / 常用制动级位
  • /eb: Emergency brake / 紧急制动
  • /st hotbar: Toggle Hotbar controller mode / 开启或关闭快捷栏手柄映射

3. Movement Authority Request / 申请行车许可 (MA)

When the track has been registered into the RailGraph topology, the driver requests authority while stationary:
在线路已完成 RailGraph 拓扑登记的前提下，司机在停车状态下执行：

/stcs ma demand                    # Request continuous Movement Authority / 申请连续移动授权

The driver HUD will display the remaining authority credit and dynamic speed curves.
顶部 BossBar 与计分板将实时显示当前区段的剩余行车授权距离与动态限速。

Standalone STF vs Full SkyRail Suite / 独立使用与全套件对比

Feature / 功能 Standalone STF / 独立 STF SkyRail Suite (STF + STCS + STA + SkyPCC)
Newton train physics / 牛顿力学列车动力学 Included / 包含 Included / 包含
Manual driving & Hotbar cab / 手动驾驶与快捷栏手柄 Included / 包含 Included / 包含
Multi-vehicle consists / 多车辆刚性编组 Included / 包含 Included / 包含
Physical turnout control / 实体道岔几何切换 Included / 包含 Included / 包含
Sign-based station automation / 牌子车站自动化 Included / 包含 Included / 包含
RailGraph topology & tracking / RailGraph 拓扑与列车追踪 — Included / 包含
Moving block & MA computation / 移动闭塞与 MA 连续演算 — Included / 包含
Pessimistic occupancy ledger / 悲观物理占用账本 — Included / 包含
Web browser dispatcher desk / Web 浏览器集中调度大屏 — Included / 包含

Environment & Requirements / 运行环境与要求

  • Server Platform / 服务端平台: Folia (Tested on Shiroha / Folia 26.2 & 26.3)
  • Runtime Environment / 运行环境: Java 21+ (Java 25 recommended / 推荐 Java 25)
  • Client Requirements / 客户端需求: Pure Vanilla Client compatible (No client-side mods needed / 纯原版客户端兼容，无需客户端 Mod)
  • Dependencies / 前置依赖: No external dependencies. The four components within the suite interoperate directly. / 无额外第三方前置，套件内部组件协同运行。

Scope & Safety Disclaimer / 适用范围与重要安全免责声明

SkyTrainFolia and SkyRail Suite are experimental software created for the Minecraft game environment. They are developed for simulation, software experimentation, and educational exploration.
SkyTrainFolia 与 SkyRail Suite 是运行于 Minecraft 环境中的实验性软件，仅用于游戏机制仿真、软件实验与教学探索。

They are NOT certified railway safety systems and do not claim compliance with industrial standards, including but not limited to:
本项目并非经过实际认证的真实铁路安全系统，亦不声称符合包括以下工业规范或标准在内的准入要求：

  • ERTMS/ETCS SUBSET-026 — System Requirements Specification
  • EN 50126 — Railway Applications – The Specification and Demonstration of Reliability, Availability, Maintainability and Safety (RAMS)
  • EN 50716:2023 — Railway Applications — Requirements for software development

The project does NOT provide:

  • A certified interlocking system / 经过认证的联锁系统
  • A certified ATP system / 经过认证的列车超速防护（ATP）系统
  • A standards-compliant ETCS implementation / 符合工业标准的 ETCS 落地实现
  • Safety-critical software for real-world railway operation / 可用于真实铁路运行的安全关键软件

Open Source & License / 开源协议与仓库

SkyTrainFolia and SkyRail Suite are open-source projects released under the MIT License.
SkyTrainFolia 与 SkyRail Suite 均为开源项目，采用 MIT License 授权协议发布。

Acknowledgements / 致谢 / Dankwoord

Special thanks to bergerkiller / Berger Healer and the contributors to BKCommonLib and TrainCarts for their pioneering work on Minecraft plugin ecosystems and minecart railway mechanics.
TrainCarts' sign interfaces and operational workflows provided significant inspiration for this project. SkyRail Suite is an independent project and does not require either plugin, nor does it claim official endorsement or complete compatibility. The applicable TrainCarts copyright and license notices remain retained.

感谢 bergerkiller / Berger Healer 及 BKCommonLib、TrainCarts 的贡献者，为 Minecraft 插件生态与矿车铁路玩法所做的长期工作。TrainCarts 的牌子接口与运行流程为本项目提供了重要参考。SkyRail Suite 是独立项目，不要求安装上述插件，亦不代表其官方版本或完整兼容实现；相关 TrainCarts 版权与许可声明继续保留。

Met dank aan bergerkiller / Berger Healer en de bijdragers aan BKCommonLib en TrainCarts voor hun jarenlange werk aan Minecraft-plugins en spoorwegen met mijnkarretjes. De bordinterfaces en bedieningsprocedures van TrainCarts waren belangrijke referenties voor dit project. SkyRail Suite is een onafhankelijk project: geen van beide plugins is vereist, het is geen officiële of door hen onderschreven versie en volledige compatibiliteit wordt niet geclaimd. De toepasselijke copyright- en licentievermelding van TrainCarts blijft behouden.