Aetherial Structure Compatibility

Aetherial Structure Compatibility

Версия: 1.0.0g
Minecraft: 1.21.1
Загрузчик: NeoForge 21.1.242+
Java: 21
Автор: OurElephant
Контакт: slon1k.nash@atomicmail.io

Мод на совместимость структур с генерацией в виде летающих островов. Переносит начало структур на подходящие летающие острова

Назначение

Aetherial Structure Compatibility (ASC) адаптирует обычную генерацию структур Minecraft под миры из отдельных летающих островов. В немодифицированном конвейере структур начало структуры выбирается по правилам биома и structure-set, без учёта того, достаточно ли terrain под будущими частями или вокруг них. В мире островов это может порождать структуры в пустоте, структуры, разделённые между несвязанными островами, комнаты без опоры или подземные структуры за пределами доступной каменной массы.

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

ASC меняет только размещение. Он не добавляет структуры, не заменяет их лут, не изменяет интервалы structure-set и не меняет правила допустимости биомов сверх проверки валидных целевых позиций.

Как это работает

1. Minecraft запрашивает начало структуры в её номинальном чанке.
2. ASC определяет структуру и загружает её индивидуальный профиль, при необходимости откатываясь к профилю defaults.
3. Ближайшие колонки сэмплируются и группируются в кандидатов-летающих островов.
4. Кандидаты-якоря ранжируются по размеру острова, толщине, свободному пространству и расстоянию переноса.
5. ASC генерирует или переносит структуру согласно generationStrategy.
6. Реальные части структуры проверяются на соответствие одному острову. Наземные структуры требуют terrain под большинством частей; подземные структуры требуют достаточного заключения или перекрытия; водные структуры требуют подходящей воды и дна.
7. Если ни одна цель не проходит проверку, global.fallback определяет, пропускается структура или остаётся на ванильной позиции.

Номинальный чанк начала остаётся владельцем структуры. Части структуры и кэшированный bounding box обновляются, чтобы размещение и /locate structure использовали перенесённую геометрию, оставаясь в пределах максимальной дистанции ссылки на структуру в восемь чанков.

Изменения в генерации структур

• Начала структур можно перемещать по горизонтали и вертикали к проверенному якорю острова.
• regenerate_at_target просит генератор структуры создать начало в целевом чанке.
• generate_then_translate сначала генерирует исходное начало, а затем перемещает все готовые части как группу.
• auto выбирает обычный путь генерации в цели, со специальной обработкой переноса для YUNG's Better Mineshafts и зарытых сокровищ.
• Наземные структуры проверяются по их реальным частям, а не только по одному большому bounding rectangle.
• Ветвящиеся шахты проверяются по частям, чтобы пустые промежутки между туннелями не считались отсутствующим terrain.
• Trial Chambers и другие подземные структуры с учётом частей выравниваются и проверяются по реальным комнатам и коридорам.
• Стандартные вертикальные опорные колонны можно отключить через verticalSupports. Отдельная совместимость с YUNG сохраняет цепи, подавляя нежелательные сплошные опорные ноги.
• Уже сгенерированные структуры не переносятся задним числом. Тестируйте изменения в новом мире или неисследованных чанках.

Производительность

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

Для больших миров и модпаков рекомендуется использовать Chunky, чтобы предварительно сгенерировать нужную область мира перед обычной игрой. Также рекомендуется C2ME для параллельной загрузки и генерации чанков — это снижает практическое влияние ASC на исследование и запуск сервера. Производительность всё ещё зависит от пресета мира, железа, модпака и значений конфигурации, поэтому тестируйте настройки на резервной копии, прежде чем генерировать рабочий мир.

Совместимость

У ASC нет обязательной зависимости от модов на структуры. Он читает активный динамический реестр STRUCTURE, поэтому стандартные структуры из модов и датапаков на основе реестра могут автоматически получать профили.

Встроенный шаблон содержит готовые к редактированию профили для:

• Ванильных структур Minecraft;
• YUNG's Better Desert Temples;
• YUNG's Better Dungeons;
• YUNG's Better Nether Fortresses;
• YUNG's Better Jungle Temples;
• YUNG's Better Mineshafts;
• YUNG's Better Ocean Monuments;
• YUNG's Better Strongholds;
• YUNG's Better Witch Huts;
• Integrated Dungeons and Structures (IDAS);
• Integrated Stronghold;
• Integrated Villages;
• Revamped Shipwrecks;
• структур Supplementaries.

Для YUNG's Better Mineshafts и YUNG's Better Dungeons включены отдельные миксины там, где эти моды ставят опорные ноги напрямую. Эти необязательные адаптеры не требуют установки модов YUNG.

Код генерации и кэширования рассчитан на параллельную генерацию мира, включая C2ME. Вспомогательные потоки генерации мира Distant Horizons не выполняют сканирование островов; там используется настроенный fallback, чтобы избежать простоев генерации чанков в рабочих потоках.

Расположение конфигурации

Файл конфигурации:

config/aetherial_structure_compat.json

Когда файла нет, ASC записывает встроенный шаблон. После того как реестр структур становится доступен, ASC дополняет файл одним полным разделом на каждую зарегистрированную структуру. Внутренние ключи, начинающиеся с _, — это маркеры миграции или шаблона, и они скрыты из игрового списка структур.

Глобальные настройки

Поля размещения по умолчанию и для отдельных структур

Объект defaults задаёт наследуемые значения. Объект верхнего уровня с идентификатором структуры, например minecraft:village_plains, переопределяет эти значения для данной структуры.

Четыре веса ранжирования не обязаны в сумме давать ровно 1.0, но нормализованная сумма делает их относительное влияние понятнее.