TrueRails

Turn vanilla rails into a real transportation system.

A pure-gameplay mod: train consists, high-speed cruising, curve safety, precision station stops, redstone dispatch, and smart chunk-loading for unmanned freight. No new items, blocks, or entities — uninstall safely with zero save damage; minecarts revert to vanilla.

• Version: 1.0.0
• Platform: Minecraft 1.21.1 · NeoForge 21.1.x · Java 21
• Requirements: must be installed on both server and client
• Author: liluo23

---

Core Features

Train Consists

• Hold a chain and right-click a minecart to select it, then right-click another to link them (consumes 1 chain)
• Sneak + empty-hand right-click a linked cart to disconnect; the chain is returned
• Up to 8 cars; at most 1 powered minecart per train, always as the locomotive
• Only the locomotive is fully physics-simulated; cars follow its path precisely. Links auto-break if spacing exceeds 8 blocks
• Sagging chains render between adjacent cars

High-Speed Cruising

• Vanilla key driving: W to accelerate, S to decelerate, Space for emergency brake; release to lock in cruise speed
• Drive from any car — input is auto-forwarded to the locomotive
• Top straight-line cruise of 48 blocks/sec (requires a fueled powered locomotive); 24 when driven by hand
• Automatic uphill compensation and downhill braking, with a smooth target-speed model

Powered Rail Redefined

• Charged powered rail = booster: +6 blocks/sec instant impulse per tile, capable of breaking the cruise cap (absolute cap 64, configurable up to 128)
• Overspeed decays exponentially with a 7-second half-life back to the cruise target
• While overspeed, the speed readout turns orange and wheels throw sparks

Curve and Slope Safety

• The locomotive continuously pre-scans the track ahead and smoothly slows in advance per a braking envelope
• Curve limit 12, slope limit 24 — corner without derailing

Precision Stops and Stations

• Uncharged powered rail = stop marker: the train smoothly brakes and stops precisely at the rail block's center
• Redstone-charge the powered rail under any car to dispatch (manual button / hopper-clock scheduled service / comparator dispatch-when-full)
• While driving, hold W to sound the horn and force a non-stop pass
• Docking state is persistent — after a restart, trains remain at the platform awaiting signal

Fuel System

• Right-click a powered minecart to open the fuel UI; insert any furnace fuel (capacity about one stack of coal)
• A throttle panel in the bottom-right sets unmanned gears: 0/8/16/24/32/48
• Fuel consumption scales with the square of speed; trains coast freely when fuel runs out
• Low-fuel (<10%) warning sound and black-smoke cue

Unmanned Freight and Chunk Loading

• Fueled, gear-set unmanned trains run on their own — auto-arriving, docking, and redstone-dispatching
• Moving corridor loading: pre-loads chunks ahead by speed × 2 seconds; ≤24 chunks per train, ≤3 trains per owner
• After fuel runs out, loading stops following a 10-second grace period; the train freezes in place and resumes when a player approaches

Speedometer HUD

• While riding, replaces the experience bar: gradient speed bar, centered readout, cruise marker, direction arrow
• With a powered locomotive, shows a mini fuel bar and percentage
• Reverse readout is greyed; overspeed turns orange

Sound Effects

Wheel clatter (denser and higher-pitched with speed), brake squeal, departure short horn, station-pass long horn, low-fuel alarm.

---

Quick Start

1. Lay track, place a powered minecart and several regular minecarts
2. Hold a chain and link them into a train
3. Right-click the powered minecart → add coal → set a gear on the throttle panel
4. To drive yourself: sit in a car and press W. For unmanned operation: set a gear and walk away
5. Build a station: lay a row of uncharged powered rails, wired to a button or redstone clock

Configuration

In-game: Mods → TrueRails → Config, or edit config/truerails-common.toml. Speed caps, acceleration/deceleration, curve limits, fuel capacity, consumption, chunk-loading quotas, and more are all adjustable. Want it faster? maxSpeed and absoluteSpeedCap go up to 128 blocks/sec.

Compatibility and Boundaries

• An unmanned, unfueled minecart crossing a powered rail behaves ≈ vanilla, compatible with redstone machines
• No cross-dimension support (entering a portal auto-breaks links); no dual locomotives
• Uninstall-safe: all data is stored as entity attachments, ignored automatically once the mod is removed, leaving no residue

Known Limitations

• Player-driven trains do not enable corridor loading (they rely on server view distance)
• Mid-train passenger cars on long consists may show slight visual offset from the formation

License

MIT

---

TrueRails 真·铁路

让原版铁路成为真正的交通系统。

纯玩法模组：列车编组、高速巡航、弯道安全、定点停车、红石发车、无人货运智能区块加载。 不添加任何新物品、新方块、新实体 —— 卸载后存档无损，矿车退化为原版矿车。

• 版本：1.0.0
• 平台：Minecraft 1.21.1 · NeoForge 21.1.x · Java 21
• 端要求：服务端 + 客户端均需安装
• 作者：liluo23

---

核心特性

列车编组

• 手持链条右键矿车选中，再右键另一辆完成连接（消耗 1 链条）
• 潜行空手右键已连接矿车断开，链条返还
• 最多 8 节；每列最多 1 辆动力矿车，且永远作为车头
• 只有车头真实物理模拟，车厢沿车头轨迹精确跟随；车距超过 8 格自动断链
• 相邻车厢间渲染下垂链条

高速巡航

• 原版按键驾驶：W 加速、S 减速、空格 紧急制动，松开即锁定巡航速度
• 坐任意车厢都可驾驶，输入自动转发车头
• 直线巡航最高 48 格/秒（需有燃料的动力车头）；徒手驾驶 24
• 上坡自动补偿、下坡自动刹车，目标速度模型平滑控速

动力轨重定义

• 充能动力轨 = 助推器：每格 +6 格/秒瞬时冲量，可突破巡航上限（绝对上限 64，配置可放宽至 128）
• 超速部分按半衰期 7 秒指数衰减，回落到巡航目标
• 超速时速度数字变橙 + 轮部火花

弯道与坡道安全

• 车头持续预扫描前方轨道，按制动包络提前平滑降速
• 弯道限速 12、坡道限速 24，过弯不脱轨

定点停车与车站

• 未充能动力轨 = 停车标：列车自动平滑制动，精确停在轨道方块中心
• 红石充能任意车厢脚下的动力轨即发车（按钮手动 / 漏斗时钟定时班车 / 比较器满载即发）
• 驾驶时按住 W 可鸣笛强制通过不停车
• 停靠状态持久化，重启后列车仍在站台等信号

燃料系统

• 右键动力矿车打开燃料界面，投入任意熔炉燃料（容量约一组煤）
• 界面右下角调速面板：无人车档位 0/8/16/24/32/48
• 油耗与速度平方成正比；燃料耗尽自然滑行
• 低燃料（<10%）警报音 + 黑烟提示

无人货运与区块加载

• 有燃料、设了档位的无人列车自行运行，自动进站、停靠、红石发车
• 移动走廊加载：前方按速度×2 秒预加载区块，单列 ≤24 区块、每车主 ≤3 列
• 燃料耗尽 10 秒宽限后停止加载，列车原地冻结，玩家接近后恢复

速度计 HUD

• 乘车时替换经验条位置：渐变速度条、居中数字、巡航标记、方向箭头
• 有动力车头时显示燃料微缩条与百分比
• 倒车数字置灰、超速变橙

音效

车轮咔嗒（随速度变密变调）、制动尖啸、发车短笛、过站长笛、低燃料警报。

---

快速上手

1. 铺轨道，放一辆动力矿车和若干普通矿车
2. 手持链条把它们连成一列
3. 右键动力矿车 → 投入煤炭 → 调速面板设档位
4. 想自己开：坐进车厢按 W；想无人运行：设档位后离开即可
5. 建车站：铺一排未充能动力轨，接上按钮或红石时钟

配置

游戏内：Mods → TrueRails → Config，或编辑 config/truerails-common.toml。 速度上限、加减速度、弯道限速、燃料容量、油耗、区块加载配额等均可调。 想要更快？maxSpeed 与 absoluteSpeedCap 最高可设 128 格/秒。

兼容性与边界

• 无人无燃料矿车经过动力轨 ≈ 原版行为，与红石机器兼容
• 不支持跨维度（进传送门自动断链）、不支持双车头
• 卸载安全：所有数据以实体附加形式存储，移除模组后自动忽略，无残留

已知限制

• 玩家驾驶的列车不启用走廊加载（依赖服务器视距）
• 长列车中部载人车厢可能与编队有轻微视觉偏差

许可

MIT