RoadWeaver

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.

Планы на будущее

• [ ] Больше придорожных украшений?
• [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
• Мод опирается на ванильные механизмы, поэтому несовместим с модами, переворачивающими ванильные механики, такими как TerraFirmaCraft: Next Generation

Конкретные проявления несовместимости:

• Генерация дорог крайне медленная
• Загрузка данных карты крайне медленная или долгое время пустая
• На карте показано, что дорога сгенерирована, но при подходе её совсем нет

Факторы, влияющие на производительность:

• Сложность рельефа мира
• Шаг поиска пути, настройка весов
• Количество одновременно генерируемых дорог и число потоков в пуле

Как использовать

• Автогенерация по умолчанию: после входа в мир дороги автоматически генерируются между структурами
• Карта дорожной сети: нажмите H, чтобы открыть отладочную карту и просмотреть дорожную сеть
• Настройка: экран настроек Cloth Config API (встроен начиная с 2.0.2), доступен на экране создания мира или в игре по нажатию H для открытия карты и затем в правом верхнем углу

Вдохновение мода

Мод создан на основе Countered's Settlement Roads, карта вдохновлена RoadArchitect.

Планы на будущее

• [ ] Больше придорожных украшений?
• [x] Связывание нескольких структур
• [ ] Связывание биомов?
• [ ] Больше красивых построек?
• [ ] Дорожные события?
• [x] Пользовательское связывание
• [ ] Система главных дорог?
• [x] Переходы из плит
• [x] Сглаживание кривыми Безье

Примечания

• Чем больше структур задано для поиска при загрузке мира, тем дольше создаётся мир, но тем выше полнота
• Дороги не могут генерироваться на уже загруженных чанках, поэтому, если дорога ещё не сгенерирована полностью, не подходите к этому участку