RoadWeaver

RoadWeaver

English | 简体中文

一个 Minecraft 模组，可在村庄或自定义结构之间自动生成美观的道路。

主要特性

1. 智能道路生成

• 智能寻路：多种寻路算法，避开陡峭和危险区域；根据地形高度、生物群系和地面稳定性调整路线
• 贝塞尔曲线：对折线路径应用贝塞尔曲线平滑，生成自然流畅的曲线，避免急转弯
• 多种道路类型：
• 人工道路：（石砖、台阶）、（泥土、泥砖）等，或在预设编辑器中自定义
• 自然道路：生物群系自适应道路材料
• 障碍规避：切割、填充地形并移除树木，确保道路可通行
• 隧道与桥梁系统：穿山隧道、跨水桥梁
• 台阶系统：在高度变化处填充台阶以提升可通行性
• 道路地基：根据道路高程平滑插值周围高度场，仅在道路高于原始地形时填充地基，形成自然的凸起斜坡，与景观无缝融合

2. 装饰系统

• 路灯系统：红石灯，自动昼夜控制
• 路标系统：距离标记和方向指示牌
• 路边结构装饰：沿道路随机生成长椅、营火等装饰结构

3. 配置选项

• 性能优化：多线程异步生成并控制并发；高度和地形缓存以减少重复计算
• 多种网络规划算法：KNN（最稀疏）/ Delaunay（最密集）/ RNG（均衡）
• 多种寻路算法：A* / 双向 A* / 流体模拟
• 道路方块自定义：在预设编辑器中自由混搭

4. 可视化工具

• 可视化调试：道路网络地图；状态颜色（已规划/生成中/已完成/失败）；交互（拖拽、缩放、右键传送）；道路数量、长度和状态统计
• 手动连接模式：按你的偏好规划道路网络

兼容性

• 新版本（2.0.0+）完全弃用旧的 /locate 命令搜索机制，不再阻塞游戏主线程
• 结构预测、道路网络规划和寻路均在专用线程池中运行；主线程仅负责驱动和结果应用

已知兼容性与性能问题

• 本模组（2.0.6+）与 Tectonic-V2 / Epic Terrain / Terralith 兼容，但与 Tectonic-V3 不兼容
• 本模组依赖原版机制，因此与 TerraFirmaCraft: The Next Generation 等会彻底改动原版机制的模组不兼容

不兼容的表现：

• 道路生成极为缓慢
• 地图数据加载极为缓慢或显示空白
• 地图显示道路已生成，但走近后却看不到道路

性能影响因素：

• 世界地形复杂度
• 寻路步长与权重配置
• 同时生成的道路数量与线程池大小

使用方式

• 自动生成：进入世界后，自动在结构之间生成道路
• 路网地图：按 H 打开调试地图并查看路网
• 配置：通过 Cloth Config API 设置界面进行配置（自 2.0.2 起内置），可在创建世界界面中打开，也可在游戏中按 H 后点击右上角打开

灵感来源

基于 Countered’s Settlement Roads，地图设计灵感来自 RoadArchitect。

未来计划

• [ ] 增加更多路边装饰？
• [x] 连接多种结构类型
• [ ] 连接生物群系？
• [ ] 增加更美观的建筑？
• [ ] 添加道路事件？
• [x] 自定义连接
• [ ] 主干道系统？
• [x] 半砖过渡
• [x] 贝塞尔曲线平滑

注意事项

• 加载世界时，配置为需要定位的结构越多，创建世界所需时间越长，但路网也会越完整
• 道路无法在已加载的区块中生成，因此请等待道路区段生成完成后再靠近

简体中文

自动在村庄或自定义结构之间生成美观道路的 Minecraft 模组。

主要特性

1. 智能道路生成

• 智能路径生成：多种寻路算法，避开陡峭与危险区域；根据地形高度、生物群系与地面稳定性调整路线
• 贝塞尔曲线：对寻路得到的折线路径应用贝塞尔曲线平滑插值，将其变为更自然的平滑曲线，避免生硬拐弯
• 多种道路类型：
• 人工道路：（石砖、石板）、（泥土、泥砖）等，也可在预设编辑器中自行搭配
• 自然道路：按生物群系自适应道路材料
• 避障系统：为确保道路的通过性，会对地形进行切削、填补、移除树木等处理
• 隧道 & 桥梁系统：遇山开山、遇水搭桥
• 半砖系统：为道路有高度差的地方填补半砖提高通过性
• 路基生成：根据道路高度对周围高度场进行平滑插值，只在道路高于原始地形时填充路基，形成自然的”凸”字形坡面，避免道路悬空的同时又完美融入了地形

2. 装饰系统

• 路灯系统：红石灯与昼夜自动控制
• 路标系统：距离标志和方向指引
• 路边结构装饰：在路旁随机生成座椅、小火堆等结构装饰

3. 配置选项

• 性能优化：多线程异步生成并发控制；高度与地形缓存减少重复计算
• 多种路网规划算法：提供 KNN（最稀疏）/ Delaunay（最密集）/ RNG（适中）三种路网规划算法
• 多种寻路算法：提供 A* / 双向 A* / 流体模拟 三种寻路算法
• 道路方块自定义：可在预设编辑器中自行搭配

4. 可视化工具

• 可视化调试：道路网络地图；状态颜色（计划/生成/完成/失败）；交互（拖拽、缩放、右键传送）；统计道路数量、长度与状态
• 手动链接模式：按自己的喜好来规划路网

兼容性

• 新版本（2.0.0 版本以上）完全抛弃了旧版依赖的原版指令 /locate 搜索机制，不会阻塞游戏主线程
• 结构预测、路网规划和寻路均在专用线程池中执行，主线程只负责驱动与结果应用

已知兼容性与性能问题

• 本模组（2.0.6 版本以上）与 Tectonic-V2 版 / 史诗地形 / Terralith 模组兼容，与 Tectonic-V3 版不兼容
• 本模组依赖原版机制，所以与群峦传说：次世代等颠覆了原版机制的模组不兼容

不兼容具体表现为：

• 道路生成极为缓慢
• 地图数据加载极为缓慢甚至长时间空白
• 地图显示已生成但走近却完全没有

性能影响因素：

• 世界地形复杂度
• 寻路步长、权重配置
• 道路同时生成数量与线程池数量

使用方式

• 默认自动生成：进入世界后道路会自动在结构间生成
• 路网地图：按 H 打开调试地图查看道路网络
• 配置选项：模组 Cloth Config API 配置界面（2.0.2 以上版本已内嵌），可在新建世界界面或在游戏中按快捷键 H 打开地图后在右上角打开

模组灵感

模组基于 Countered’s Settlement Roads 制作，地图灵感来源 RoadArchitect。

未来计划

• [ ] 更多路边装饰？
• [x] 链接多种结构
• [ ] 链接群系？
• [ ] 更多精美建筑？
• [ ] 路途事件？
• [x] 自定义链接
• [ ] 主路系统？
• [x] 半砖过渡
• [x] 贝塞尔曲线平滑

注意事项

• 设置里加载世界时定位的结构数量越多，创建世界的时间就越久，完整度越高
• 道路无法在已加载区块上生成，所以，如道路未生成完毕，请不要走近该路段