1.3.2+mc21.1 — 预热周边区域

本次更新

这次解决一个很实际的问题：TP 到远方一个从没去过的地方，那儿也能立刻有铁路和车站，不用等卡顿。

以前区域的铁路规划是在你走到那儿、区块开始生成的那一刻才开始算的。路程远、区域大，第一次进去会明显卡一下，而且靠边界的地方可能先出现断头路。现在改成：进入一个区域时，顺手把周围一圈区域的规划提前算好。

新增配置项（3 项）

游戏内配置界面「世界生成」分类下，或直接改 .minecraft/config/zongheng_railway-common.toml：

配置项	默认	说明
preheatAroundPlayer	true	预热周边区域总开关
preheatRadius	1	提前规划周围几圈区域，0 - 3。1 表示 3×3 个区域（12288×12288 格）
planTimeoutSeconds	60	区块生成等待规划的最长秒数，超时后先让区块正常生成。0 表示一直等（原版行为）

顺手修的一个老问题

原来区块生成等待规划是没有超时的，万一某个区域算得慢，会一直卡住，表现为画面卡死不加载。现在有了超时保护：超时后这个区块先正常生成（这一段暂时没铁轨），规划继续在后台跑完，走开再回来就补上了。

使用前请知悉

「预热周边区域」只把规划（选站、连边、算线路）提前算完，不会在没加载的区块里凭空放下路轨方块。路轨仍然由区块生成时铺设；如果你开着「铁轨生成器」，还要走到 100 格以内才会真正铺轨。

因此它能让「走到远方立刻就有铁路和车站」，并减少首块生成卡顿；但它不会让一条本来就不经过某地的线路改道。

兼容性

项目	版本
Minecraft	1.21.1
NeoForge	21.1.211 及以上
机械动力 Create	6.0.6-98
Cloth Config（可选）	15.0 及以上，15.0.140 测试通过
Java	21

与原版 TongDaRailway 的 mod id 不同，不能和上游版本同时安装。

安装

1. 安装 NeoForge 21.1.211+ 与 Minecraft 1.21.1
2. 把 zongheng_railway-1.3.2+mc21.1.jar 放进 mods 文件夹
3. 需要机械动力（Create）
4. 想要图形配置界面，再额外安装 Cloth Config

完整变更

• 新增「预热周边区域」，进入新区域时提前规划周围一圈区域
• 新增规划超时保护，避免区块生成被无限期阻塞
• 新增 3 个配置项与对应中英文本地化（配置界面同步）
• README 补充新配置项说明与能力边界

完整变更记录：v1.3.1-mc21.1...v1.3.2-mc21.1

1.3.1+mc21.1 — 游戏内配置界面

本次更新

新增游戏内配置界面：不用再手动翻 .minecraft/config/zongheng_railway-common.toml，进游戏在 模组列表 -> 纵横铁路 -> 配置 里就能改，保存后立即生效。

配置界面基于 Cloth Config（可选依赖）。不装它模组照常运行、铁路照常生成，只是没有图形界面，仍然可以直接编辑 toml 文件。

界面里的配置项

共三类 9 项，全部对应已有配置：

世界生成

• 全世界生成铁路（总开关）
• 生成概率（0 - 1）
• 区域半径（0 - 100000）
• 相邻区域路网连通

轨道

• 双线轨道
• 双线间距（2 - 8 格）

铁轨生成器

• 启用铁轨生成器
• 生成铁轨生成器
• 由生成器铺设铁轨

兼容性

项目	版本
Minecraft	1.21.1
NeoForge	21.1.211 及以上
机械动力 Create	6.0.6-98
Cloth Config（可选）	15.0 及以上，15.0.140 测试通过
Java	21

与原版 TongDaRailway 的 mod id 不同，不能和上游版本同时安装。

安装

1. 安装 NeoForge 21.1.211+ 与 Minecraft 1.21.1
2. 把 zongheng_railway-1.3.1+mc21.1.jar 放进 mods 文件夹
3. 需要机械动力（Create）
4. 想要图形配置界面，再额外安装 Cloth Config

完整变更

• 新增游戏内配置界面（Cloth Config 可选依赖）
• 配置保存后即时生效，无需重开世界或重启游戏
• 新增 29 条配置相关的中英文本地化
• README 补充新配置项与构建说明

完整变更记录：v1.3.0-mc21.1...v1.3.1-mc21.1

ZongHeng Railway 1.3.0 — MC 1.21.1 / NeoForge 21.1

ZongHeng Railway 1.3.0 — MC 1.21.1 / NeoForge 21.1

纵横铁路 1.3.0。本次两个新功能，默认都开启，都可以在配置里关掉。

本次改动

双线轨道：新增 doubleTrackEnabled（默认 true）与 trackSpacing（默认 3，范围 2–8）。开启后每条线路生成两条平行轨道，间距由 trackSpacing 控制，车站出口用分岔道连接。想要原来的单线，把 doubleTrackEnabled 设为 false 即可。

跨区域路网连通：新增 connectAcrossRegions（默认 true）。原先每个 4096×4096 的区域各生成一张独立路网，区域之间至少有 120 格空隙、互不相连；开启后相邻区域会在共享边界处按同一套种子算出完全相同的对接点（坐标与高度都由噪声和种子确定，两侧必然一致），铁路可以一路走穿区域边界。设为 false 恢复各区域独立。

顺带修复：同一直线上的三点会被判为同一条边，导致整条线路被丢弃；现在线路 ID 改为无向点对哈希，不会再吞边。三岔以上的车站统一用 4 出口，两岔用 2 出口直线站。

安装

需要	版本	说明
Minecraft	1.21.1	只支持这一个版本
NeoForge	21.1.x	用 21.1.211 编译，21.1 系列均可
机械动力 Create	1.21.1 适用版本	前置，必须装（本模组用 6.0.6 编译，更高的 6.x 一般也能跑）

把 zongheng_railway-1.3.0+mc21.1.jar 和 Create 一起放进 mods/ 即可。modid 与上游 TongDaRailway 不同，不要同时安装。

配置

配置文件：config/zongheng_railway-common.toml（首次进游戏后生成），改完需重启游戏。

配置项	默认	说明
generateRailwayEverywhere	true	全世界生成总开关
areaGenerationRailwayProbability	0.4	仅总开关关闭时生效
maxRegionDistance	100	仅总开关关闭时生效（1 区域 = 4096 格）
connectAcrossRegions	true	相邻区域在边界处对接路网
doubleTrackEnabled	true	双线轨道
trackSpacing	3	仅双线开启时生效，范围 2–8
enableTrackSpawner / generateTrackSpawner / placeTracksUsingTrackSpawner	true	铁轨生成器方块相关

注意

只影响尚未生成的区域，已生成区块的路网会被存档数据固定。旧存档升级前请先删除未探索区块，否则交界处可能出现半截铁路。全世界生成 + 双线会明显增加世界生成的计算量，低配机器或大型服务器建议先跑一小片看看。

许可

GNU GPL-3.0。原作者 hello_luckyhuang、MarbleGate、MagicalChao；本分支由 orange838 维护，完整对应源码见本仓库。

本页文案由 AI 辅助生成，内容经维护者核对。

ZongHeng Railway 1.2.0 — MC 1.21.1 / NeoForge 21.1

基于 TongDaRailway 通达铁路 1.1.5 的 GPL-3.0 分支，主要改动是把「全世界生成铁路」做成了开关。

装之前要准备什么

需要	版本	说明
Minecraft	1.21.1	只支持这一个版本
NeoForge	21.1.x	用 21.1.211 编译，21.1 系列均可
机械动力 Create	1.21.1 适用的版本	前置，必须装（本模组用 6.0.6 编译，更高的 6.x 版本一般也能跑）

安装：把 zongheng_railway-1.2.0+mc21.1.jar 和 Create 一起放进 mods/ 即可，没有其它前置。

这个分支改了什么

• 全世界生成开关：新增 generateRailwayEverywhere，默认 开启。上游从 1.1.0 起把「每个区域都生成铁路」改成了按概率抽签（areaGenerationRailwayProbability 默认 0.4，约六成区域没有铁路）；开启本开关后每个区域都会生成，等于恢复 1.1.0 之前的行为。想要原版的稀疏效果，把它设为 false 即可。
• 区域距离上限可配置：新增 maxRegionDistance，默认 100 区域（约 40 万格半径），替代原先写死的 ±100 判断。
• 改名为 ZongHeng Railway / 纵横铁路：modid zongheng_railway，包名 com.orange838.zongheng。因为 modid 变了，不要和原版 TongDaRailway 同时安装。

配置

配置文件：config/zongheng_railway-common.toml（首次进游戏后生成），改完需重启游戏。

配置项	默认	说明
generateRailwayEverywhere	true	全世界生成总开关，关了才看下面两项
areaGenerationRailwayProbability	0.4	单个区域生成铁路的概率
maxRegionDistance	100	距原点多远的区域仍会生成（1 区域 = 4096 格）
enableTrackSpawner / generateTrackSpawner / placeTracksUsingTrackSpawner	true	铁轨生成器方块相关开关

注意

• 只影响尚未生成的区域。已生成区块的路网会被存档数据固定，旧存档升级前请先删除未探索区块，否则会出现半截铁路。
• 全世界生成会明显增加世界生成时的计算量，低配机器或大型服务器建议先用默认值试一个区域。

许可

GNU GPL-3.0。原作者 hello_luckyhuang、MarbleGate、MagicalChao；本分支由 orange838 维护，完整对应源码见本仓库。

---

本页文案由 AI 辅助生成，内容经维护者核对。

ZongHeng Railway 1.2.0 — MC 1.21.1 / NeoForge 21.1

纵横铁路 1.2.0（Minecraft 1.21.1 / NeoForge 21.1）

基于 TongDaRailway 通达铁路 1.1.5 的 GPL-3.0 分支。

本次改动

• 加回「全世界生成铁路」开关：新增 generateRailwayEverywhere（默认 true）。上游自 1.1.0 起用 areaGenerationRailwayProbability = 0.4 限制为只有约 40% 的区域生成路网；开启本开关后每个区域都会生成，恢复 1.1.0 之前的行为，设为 false 则回到受限生成。
• 区域距离上限可配置：新增 maxRegionDistance（默认 100 区域 ≈ 40 万格），替代原先写死的 ±100 判断。
• 改名为 ZongHeng Railway / 纵横铁路：modid zongheng_railway，包名 com.orange838.zongheng，主类 ZongHengRailway。
• 国内构建支持：新增 gradle/china-mirror.init.gradle（BMCLAPI + creeperhost 镜像 + 本地 mojang-meta 替身），官方 maven 不可达时也能构建。

安装

1. Minecraft 1.21.1 + NeoForge 21.1.x
2. 需要机械动力 Create 6.0.6 及其依赖（Flywheel、Ponder、Registrate）
3. 把 zongheng_railway-1.2.0+mc21.1.jar 放进 mods/

配置

配置文件：config/zongheng_railway-common.toml，改完需重启游戏。

配置项	默认	说明
generateRailwayEverywhere	true	全世界生成总开关
areaGenerationRailwayProbability	0.4	仅总开关关闭时生效
maxRegionDistance	100	仅总开关关闭时生效

注意

• 本模组只影响尚未生成的区域；已生成区块的路网由存档数据固定，旧存档升级前请删除未探索区块。
• 上游原版与本分支 modid 不同，不要同时安装。

许可

GNU GPL-3.0。原作者 hello_luckyhuang、MarbleGate、MagicalChao；本分支由 orange838 维护，完整源码见本仓库。