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。

未来计划

• 更多路边装饰？
• 链接多种结构类型
• 链接生物群系？
• 更精美的建筑？
• 路途事件？
• 自定义链接
• 主干道系统？
• 台阶过渡
• 贝塞尔曲线平滑

注意事项

• 加载世界时配置的定位结构越多，世界创建时间越长，但路网越完整
• 道路无法在已加载的区块上生成，因此请勿在道路生成完成前靠近该路段