RoadWeaver - 路织者

RoadWeaver

English | [简体中文](README_CN.md)

一个能在村庄或自定义结构之间自动生成美观道路的 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] 贝塞尔曲线平滑

注意事项

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