True-Rails

TrueRails Real Rail

Make the original railway a true transportation system. **

Pure gameplay mod: train consist, high-speed cruising, curve safety, precise parking, redstone departure, and unmanned freight intelligent block loading. No new items, blocks, or entities added —— save files remain intact after uninstallation; minecarts revert to vanilla behavior.

• Version: 1.0.0
• Platform: Minecraft 1.21.1 · NeoForge 21.1.x · Java 21
• Installation: Required on both server and client
• Author: liluo23

\---

Core Features

Train Composition

• Hold the chain in hand, right-click a minecart to select it, then right-click another cart to connect (consumes 1 chain)
• While sneaking and empty-handed, right-click a connected minecart to disconnect; the chain is returned
• Maximum of 8 links; only one powered minecart per train, which must always be at the front
• Only the lead cart undergoes realistic physics simulation; trailers precisely follow the lead cart's path; chains automatically break if carts are spaced more than 8 blocks apart
• Chains are rendered sagging between adjacent carts

High-speed cruise

• Original key controls: W to accelerate, S to decelerate, Space for emergency brake—release to lock cruise speed
• Drive from any carriage; input automatically forwards to the front car
• Maximum straight-line cruise speed of 48 tiles per second (requires a fuel-powered front car); manual driving speed is 24
• Automatic uphill compensation and downhill braking, with smooth speed control via target-speed model

Power Track Redefined

• Recharge Power Track = Booster: Provides an instant impulse of +6 units/second per tile, allowing to exceed cruise speed limit (absolute cap at 64, configurable up to 128)
• Excess speed decays exponentially with a half-life of 7 seconds, returning to the target cruise speed
• When overspeeding, the speed display turns orange and sparks appear on the wheels

Safety on Curves and Slopes

• Continuously pre-scans the track ahead and smoothly decelerates in advance according to braking envelope
• Curve speed limit 12, incline speed limit 24, ensuring no derailment when navigating curves

Fixed Parking and Stations

• Unpowered powered rails = stop sign: Train automatically brakes smoothly and stops precisely at the center of the rail block
• Redstone power applied to any powered rail beneath a car triggers departure (manual button, hopper clock for scheduled departures, or comparator-based full-load trigger)
• While driving, hold down W to sound the horn and force passage without stopping
• Stationary state is persistent; after restart, the train remains on the platform awaiting signal

Fuel System

• Right-click the powered minecart to open the fuel interface, and insert any furnace fuel (approximately one stack of coal)
• The speed control panel in the bottom-right corner of the interface: unmanned cart gears 0/8/16/24/32/48
• Fuel consumption is proportional to the square of speed; the cart will coast naturally when fuel runs out
• Low fuel (<10%) triggers an alarm sound and black smoke warning

Autonomous Freight and Block Loading

• Unmanned trains with fuel and set gear run automatically, entering stations, stopping, and departing via redstone signals
• Moving corridor loading: Blocks are preloaded ahead based on speed × 2 seconds; single train ≤24 blocks, per player ≤3 trains
• After a 10-second grace period upon fuel depletion, loading stops, the train freezes in place, and resumes when the player approaches

Speedometer HUD

• Replace the experience bar with a gradient speed bar, centered number, cruise marker, and directional arrow while driving
• Display fuel mini-bar and percentage when using a powered vehicle head
• Gray out reverse numbers and turn speed over limit to orange

Sound Effects

Wheel clicks (increasing in frequency and pitch with speed), brake screech, departure whistle, station pass flute, low fuel alarm.

\---

Quick Start

1. Lay down tracks and place one powered minecart along with several regular minecarts
2. Use a chain to link them together in a line
3. Right-click the powered minecart → insert coal → set the speed on the control panel
4. To drive manually: enter the cart and press W; for unattended operation: set the speed and leave it
5. Build a station: place a row of unpowered powered rails, then connect them to a button or redstone clock

Configuration

In-game: Mods → TrueRails → Config, or edit config/truerails-common.toml. Adjustable settings include speed limit, acceleration/deceleration, curve speed limits, fuel capacity, fuel consumption, and chunk loading quota. Want to go faster? Set maxSpeed and absoluteSpeedCap up to 128 blocks per second.

Compatibility and Boundaries

• Unmanned and unfueled minecarts passing over powered rails ≈ original behavior, compatible with redstone machinery
• Does not support cross-dimensional travel (automatically disconnects when entering portals), does not support dual locomotives
• Safe uninstallation: All data is stored as entity attachments; automatically ignored upon module removal, with no residue left behind

Known Limitations

• The train driven by the player does not enable corridor loading (depends on server view distance)
• Middle passenger cars of long trains may have 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 格自动断链
• 相邻车厢间渲染下垂链条

高速巡航