RoadWeaver

RoadWeaver — это мод для Minecraft Java Edition, который автоматически создаёт красивые дорожные сети между игровыми структурами, такими как деревни. Мод использует несколько алгоритмов поиска пути, чтобы избегать крутых склонов и опасных зон, а также позволяет настраивать материалы дорог, добавлять декорации вроде фонарей и скамеек, а также вручную корректировать маршруты через карту отладки.

Как работает генерация дорог

Мод автоматически прокладывает дороги между структурами после загрузки мира, используя несколько алгоритмов поиска пути. Эти алгоритмы анализируют высоту местности, биомы и устойчивость грунта, чтобы найти оптимальный маршрут, избегая крутых и опасных участков. Для плавности линий применяются кривые Безье, что делает дороги естественными и избавляет от резких поворотов.

В процессе генерации мод может вырубать деревья, срезать холмы или заполнять ямы, чтобы обеспечить проходимость. Если дорога пересекает воду, над ней автоматически возводится мост, а через горы прокладывается туннель. При изменении высоты рельефа используются половинчатые блоки (слайбы) для создания плавных переходов. Под дорогой создаётся фундамент, который заполняется только там, где дорога возвышается над оригинальным ландшафтом, формируя естественные наклонные поверхности.

Настройка и типы дорог

Игроки могут выбирать между искусственными и натуральными дорогами. Искусственные дороги используют материалы вроде каменных кирпичей, слэбов, земли или глиняных кирпичей, а их комбинации можно настраивать в редакторе пресетов. Натуральные дороги автоматически подстраиваются под материалы конкретного биома.

Для планирования дорожной сети доступны три алгоритма: KNN (для самых разреженных сетей), Delaunay (для самых плотных) и RNG (сбалансированный вариант). Также можно выбирать алгоритмы поиска пути: классический A*, двусторонний A* или симуляцию жидкости. Все настройки доступны через интерфейс Cloth Config API, который можно открыть во время создания мира или в игре, нажав клавишу H и кликнув в правом верхнем углу.

Система декораций и визуализация

Мод автоматически украшает дороги, размещая вдоль них случайные декорации: скамейки, костры и другие структуры. Освещение обеспечивается системой ламп на красном камне, которые автоматически включаются и выключаются в зависимости от времени суток. Также устанавливаются указатели с расстояниями и направлениями.

Для контроля процесса генерации доступна карта отладки. Нажатие клавиши H открывает её, где отображается текущее состояние дорожной сети: планируемые, генерируемые, завершённые или неудачные участки обозначены разными цветами. На карте можно перетаскивать элементы, масштабировать их и нажимать правой кнопкой мыши для мгновенного перемещения к точке. Здесь же можно переключиться в режим ручной прокладки, чтобы самостоятельно спланировать маршруты между структурами.

Ограничения и совместимость

Важно помнить, что дороги не могут генерироваться на уже загруженных чанках. Если вы подойдёте к участку, который ещё не сгенерировался, он останется пустым до завершения процесса. Также стоит учитывать, что увеличение количества структур, которые мод должен найти при загрузке мира, значительно увеличивает время его создания.

Начиная с версии 2.0.0, мод перестал использовать команду /locate, что решило проблему блокировки главного потока игры. Однако у него есть ограничения в совместимости. Мод несовместим с Tectonic-V3, а также с модами, которые полностью переписывают механики игры, например, TerraFirmaCraft: The Next Generation. Проблемы совместимости проявляются в крайне медленной генерации дорог, долгой загрузке карты или её полном отсутствии при подходе к участку.

Требования проверенного файла

• По манифесту для файла roadweaver-fabric-2.3.1-1.21.1-hotfix.jar (Minecraft 1.21.1; Fabric) требуется cloth-config2.
• По манифесту для файла roadweaver-fabric-2.3.1-1.21.1-hotfix.jar (Minecraft 1.21.1; Fabric) требуется fabric-api.