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

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.

🎨 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.

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 offers deep optimization potential. By properly aligning portals and tuning settings, you can reduce the CPU cost of train teleportation to near zero.

Tip 1: The "Straight-Through" Clone Optimization
If a teleported train does not change its absolute direction (e.g., Entry faces North, Exit faces South, so the train moves straight through), Rift Rail smartly utilizes the ultra-fast native Factorio clone API. Teleporting a fully loaded train this way costs almost zero UPS. When planning main line logistics, try to keep the Entry and Exit portals facing opposite directions (straight in, straight out).
Tip 2: 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 script CPU 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. Combined with the "Clone Optimization", your UPS will remain rock-solid.

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.

裂隙铁路 - Rift Rail

跨维度列车运输系统

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

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

核心特性

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

🚂 全类型支持
完美支持机车、货运车厢、流体车厢和大炮车厢。坐在车内的玩家也会随车辆瞬间传送。

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

物流集成与路由

🚀 Space Exploration
深度集成。传送门可以在飞船上正常工作，并在飞船起飞、降落和克隆事件中无缝保持连接。

📦 Logistic Train Network (LTN)
原生支持跨地表运输。在新的多对多架构下，列车会自动选择距离其目的地最近的可用传送门。

关于 Cybersyn： 由于底层架构冲突，v0.10 版本已移除对 Cybersyn 的支持。

🌐 多对多路由
从 v0.10 开始，Rift Rail 支持复杂的路由网络：

多对一 (最多5个)： 将多个入口连接到单个出口。
一对多（最多5个）： 将单个入口连接到多个出口，并通过电路信号控制路由，或让 LTN 自动选择最佳路径。

平衡性与游戏进程

本模组现已支持多种平衡模式，以适应您期望的游戏风格。您可以在 模组设置 (启动项) 中进行选择。非常感谢玩家 Ldmf 为我们设计并实现了这套完善的进程系统！

普通模式 (默认): 标准体验。配方和科技被设计在游戏中期解锁。
简单模式: 配方极其廉价，适合不受限制的建设。
硬核模式 (SE, K2, 太空时代): 将 Rift Rail 深度整合进大型模组的大后期。您将需要纳奎矿或物质等终局资源才能建造您的第一个传送门。

重要提示： 更改此设置需要重启游戏。

💡 进阶：性能与 UPS 优化指南

对于追求极致性能的巨型基地玩家，Rift Rail 在底层提供了深度的优化空间。通过合理的建筑摆放和参数调整，您可以将列车传送的 CPU 消耗降至最低。

核心技巧 1：利用“直通”克隆优化
当列车传送后不需要改变绝对朝向时（例如：入口朝北，出口朝南，列车笔直穿过），系统将智能调用极速的 Factorio 原生 clone API。此时一整列满载火车的传送几乎不消耗任何 UPS。因此在规划干线时，建议尽量保持入口和出口方向相反（直进直出）。
核心技巧 2：平衡“传送速度”与“检测频率”
您可以在模组设置中调整这两个核心参数。提高放置检测间隔（如 2 或 3）可大幅降低脚本 CPU 消耗，但会导致车厢连接延迟。较高的传送时车辆速度会增加吞吐量，但必须配合极低的检测间隔，否则会导致列车拉断。
- 推荐高吞吐量模式（默认）：检测间隔 1，传送速度 1.0 ~ 2.4。
- 推荐终极 UPS 环保模式（千瓶基地）：检测间隔 3 或 4，传送速度 0.5 ~ 1.0。搭配“直通”克隆优化，极大地降低脚本运算频率。

致谢

特别感谢：
Ldmf：感谢其对原版、SE、K2 和 Space Age 的配方、科技及数据结构进行的全面重构与巨大贡献。
Harag (se-ltn-glue 的作者)：感谢其开创的事件驱动型跨地表交付设计模式，为本模组的集成方案提供了重要启发。
Cybersyn、LTN 和 Space Exploration 的创作者：感谢你们提供的强大框架，使本模组成为可能。

Support Space Exploration:
Earendel's Patreon: https://www.patreon.com/earendel
Try the Space Exploration mod: https://mods.factorio.com/mod/space-exploration

支持 Space Exploration：
Earendel 的 Patreon：https://www.patreon.com/earendel
尝试 Space Exploration 模组：https://mods.factorio.com/mod/space-exploration