RoadWeaver - Tec3

RoadWeaver - Tec3

RoadWeaver模组的TectonicV3兼容版本。

免责声明: 此分支仅增加对 Tectonic v3 的支持。尚未(或暂时没有?)对原版 RoadWeaver 实现其他改进。

支持 Tectonic v3 的 RoadWeaver

这是由 shiroha 开发的原始 RoadWeaver 的分支,增加了对 Tectonic v3 的支持。原模组的所有功劳归其创作者所有。


RoadWeaver

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

主要特性

1. 智能道路生成

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

2. 装饰系统

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

3. 配置选项

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

4. 可视化工具

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

兼容性

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

已知兼容性与性能问题

  • 此分支支持 NeoForge 1.21.1 上的 Tectonic 3.0.28,包括自定义地形高度限制和替代噪声缩放。参见 Tectonic 3 指南 和 配置参考。
  • 更新时保留现有区块和道路。道路随新区块生成而出现;已探索的区块不会被追溯铺设。
  • 此模组依赖原版机制,因此与彻底重写原版机制的模组(如 TerraFirmaCraft: The Next Generation)不兼容

不兼容症状:

  • 道路生成极其缓慢
  • 地图数据加载非常慢或空白
  • 地图显示道路已生成,但靠近时没有任何东西出现

性能影响因素:

  • 世界地形复杂度
  • 寻路步长和权重配置
  • 并发道路生成数量和线程池大小

使用方法

  • 自动生成:进入世界后,道路会在结构之间自动生成
  • 道路网络地图:按 H 打开调试地图查看道路网络
  • 配置:Cloth Config API 设置界面(自 2.0.2 起内置),可从世界创建界面进入,或在游戏内按 H 后点击右上角进入

灵感来源

基于 Countered's Settlement Roads,地图灵感来自 RoadArchitect。

未来计划

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

注意事项

  • 加载世界时配置定位的结构越多,世界创建耗时越长,但道路网络越完整
  • 道路无法在已加载的区块上生成,因此不要在道路段生成完成前靠近它们