RoadWeaver

RoadWeaver

английский | 简体中文

Мод Minecraft, который автоматически создает красивые дороги между деревнями или пользовательскими постройками.

Ключевые особенности

1. Генерация умных дорог

• Интеллектуальный поиск пути: несколько алгоритмов поиска пути, которые позволяют избегать крутых и опасных участков; корректирует маршруты в зависимости от высоты местности, биомов и устойчивости почвы.
• Кривые Безье: применяет сглаживание кривой Безье к полилинейным путям, создавая естественные плавные кривые и избегая резких поворотов.
• Несколько типов дорог:
  • Искусственные дороги: (каменные кирпичи, плиты), (грунтовые, сырцовые кирпичи) и т. д. или настройте свои собственные в редакторе пресетов.
  • Естественные дороги: био-адаптивные дорожные материалы.
• Обход препятствий: обрезает, заполняет местность и удаляет деревья, чтобы обеспечить проходимость дороги.
• Система туннелей и мостов: туннели через горы, мосты над водой.
• Система перекрытий: заполняет плиты при перепадах высот для улучшения проходимости.
• Фундамент дороги: плавно интерполирует окружающее поле высот на основе высоты дороги, заполняет фундамент только тогда, когда дорога находится над исходной местностью, создавая естественные выпуклые склоны, которые плавно сливаются с ландшафтом.

2. Система украшений

• Система ламп: лампы Redstone с автоматическим контролем дня/ночи.
• Система указателей: указатели расстояния и указатели направления.
• Украшения придорожных сооружений: вдоль дорог случайным образом генерируются скамейки, костры и другие декоративные конструкции.

3. Параметры конфигурации

• Оптимизация производительности: многопоточная асинхронная генерация с контролем параллелизма; кэширование высоты и рельефа для уменьшения избыточных вычислений
• Множественные алгоритмы планирования сети: KNN (самый разреженный) / Делоне (самый плотный) / 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 打开调试地图查看道路网络
• 配置选项: API настройки ткани 配置界面（2.0.2以上版本已内嵌）,可在新建世界界面或在游戏中按快捷键 H 打开地图后在右上角打开

模组灵感

模组基于 Дороги поселения Контред 制作，地图灵感来源 RoadArchitect。

未来计划

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

注意事项

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