---

🌐 Languages / 支持语言

English | 简体中文 | 日本語

---

---

• If you encounter any usage problems, please read the FAQ first.
• 如果有使用问题，请先阅读FAQ.

---

相关文档/DOC

• RiftRail API (EN)
• RiftRail API (CN)

---

Rift Rail - 裂隙铁路

Interdimensional Train Transportation

Create seamless railway connections across surfaces and spaceships. Rift Rail offers a compact, high-tech solution for logistics in sprawling bases or multi-surface empires.

Unlike traditional bidirectional connections, Rift Rail utilizes an asymmetric, one-way teleportation system. This design allows for flexible network topologies, enabling you to build complex one-way loops or simple point-to-point transfers with ease.

Core Features

🌌 Asymmetric Teleportation Configure each portal as Entry, Exit, via a simple GUI. This flexibility allows you to design traffic flows that suit your specific needs, from simple shortcuts to complex cross-surface routing.

🚂 Full Transport Support Works flawlessly with locomotives, cargo wagons, fluid wagons, and artillery wagons. Players inside the train are teleported instantly along with the vehicle. Extreme Compatibility Statement: Unmatched support for modded trains! Whether you have adorable 1-tile mini-wagons or massive behemoths up to 12 tiles long (double the vanilla length), Rift Rail effortlessly adapts to let them glide through portals smoothly.

🎨 Organization & UX

• Customization: Assign custom names and icons to portals for easy identification.
• Grid Snapping: Forced 2×2 rail grid alignment ensures perfect track connections every time.

Logistics Integration & Routing

🚀 Space Exploration Deep integration. Portals function correctly on spaceships and maintain connections seamlessly through liftoff, landing, and cloning events.

📦 Logistic Train Network (LTN) Native support for cross-surface deliveries. With the new N-to-M architecture, trains will automatically select the closest available portal to their destination.

🤖 Cybersyn 2 (CS2) Re-introduced in v0.12 with native support. Integrates via CS2's route plugin API to enable cross-surface dispatching, with automatic global-optimal portal selection based on combined approach and exit-to-destination distances.

• Note on Cybersyn: Support for Cybersyn has been removed in v0.10 due to fundamental architectural conflicts.

🌐 Many-to-Many Routing As of v0.10, Rift Rail supports complex routing

• Many-to-One (up to 5): Connect multiple Entry portals to a single Exit.
• One-to-Many (up to 5): Connect a single Entry to multiple Exits and control routing via circuit signals or let LTN auto-select the best path.

Balancing & Progression

This mod now features multiple balancing modes to fit your desired playstyle, accessible via the Mod Settings (Startup). A huge thank you to Ldmf for designing and implementing this comprehensive progression system!

• Normal Mode (Default): The standard Rift Rail experience. The recipe and technology are designed to be unlocked in the mid-game.
• Easy Mode: For those who want to build without constraints. The recipe is extremely cheap.
• Hardcore Modes (SE, K2, Space Age): Integrates Rift Rail deep into the endgame of major overhaul mods. You will need access to late-game resources (like Naquium or Matter) to build your first portal.

Important: Changing this setting requires a game restart.

💡 Advanced: Performance & UPS Tuning

For megabase builders pushing for maximum performance, Rift Rail now inherently features an ultimate "Zero-Copy" architecture. Regardless of whether portals are placed parallel or at a 90-degree intersection, the system uses stateless mathematical prediction to utilize the ultra-fast native Factorio clone API for all entities. The teleportation action itself consumes almost zero UPS, meaning you can place portals in any orientation without performance penalties.

• Tip: Balancing "Teleport Speed" and "Placement Interval"

You can adjust these core parameters in the Mod Settings. Increasing the Placement Interval (e.g., to 2 or 3) significantly reduces overall script CPU polling usage but delays carriage connection. Higher Teleport Speeds increase throughput but MUST be paired with lower intervals to prevent trains from snapping.

• Recommended High Throughput (Default): Interval 1, Speed 1.0 ~ 2.4.
• Recommended UPS-Eco (Megabases): Interval 3 or 4, Speed 0.5 ~ 1.0. This drastically reduces script polling frequency.

Acknowledgments

• Special thanks to:
• Ldmf for the massive contribution on overhauling recipes, technologies, and data structure for Vanilla, SE, K2, and Space Age.
• Harag (author of se-ltn-glue) for pioneering the event-driven cross-surface delivery design pattern that heavily inspired our integration approach.
• The creators of: Cybersyn, LTN, and Space Exploration for providing the robust frameworks that make this mod possible.
• hgschmie for helpful guidance on LTN cross-surface integration.

---

裂隙铁路 - Rift Rail

跨维度列车运输系统

在不同的地表和飞船之间建立无缝的铁路连接。Rift Rail 为庞大的基地或多地表帝国提供了一种紧凑、高科技的物流解决方案。

与传统的双向连接不同，Rift Rail 采用非对称的单向传送系统。这种设计允许极高的拓扑灵活性，让你能够轻松构建复杂的单向循环或简单的点对点传送。

核心特性

🌌 非对称传送 通过 GUI 将每个传送门配置为 入口、出口 模式。这种灵活性允许你根据具体需求设计交通流，无论是简单的捷径还是复杂的跨地表路由。

🚂 全类型支持 完美支持机车、货运车厢、流体车厢和大炮车厢。坐在车内的玩家也会随车辆瞬间传送。 极限兼容声明：完美兼容各路模组中的特殊列车配置！最短支持单格迷你车厢，最长支持达到 12 格（约为原生长度的 2 倍）的极限巨型车辆，依然保持毫秒级丝滑护盾穿行。

🎨 管理与交互

• 自定义标识：为传送门设置自定义名称和图标，便于识别。
• 网格对齐：强制 2×2 铁轨网格对齐，确保每次都能完美连接铁轨。