YUNG's API (Forge)

Общий фундамент модов YUNG

YUNG's API представляет собой библиотеку общих функций и абстракций данных для проектов YUNG. Она не создаёт самостоятельное приключение, а предоставляет код, которым пользуются моды, перерабатывающие шахты, подземелья и другие структуры мира.

Начиная с Minecraft 1.16.5 соответствующая версия библиотеки требуется всем модам YUNG. Если её нет или выпуск не совпадает с зависимым проектом, загрузчик обычно останавливает запуск до входа в мир.

Что находится внутри

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

• AutoRegistration упрощает регистрацию полей на поддерживаемых новых ветках.
• Jigsaw Manager предлагает собственную реализацию с дополнительными типами элементов пулов.
• JSON поддерживается через интерфейсы сериализации и готовые адаптеры.
• Утилиты включают операции с векторами, позициями колонок и рандомизацией блоков или предметов.

Сравнение с YUNG's Better Mineshafts

YUNG's Better Mineshafts заметно меняет заброшенные шахты, добавляет варианты туннелей, рабочие зоны и находки. YUNG's API не выполняет эту работу самостоятельно, а даёт таким модам общий технический инструментарий. Для полноценной установки обычно нужны оба файла.

Выбор версии

На основной странице доступны Forge- и NeoForge-сборки, а Fabric-вариант вынесен в отдельный проект. Нужно сопоставить точную версию Minecraft, загрузчик и ветку каждого мода YUNG. Похожий номер файла для другого загрузчика не является совместимой заменой.

При обновлении worldgen-сборки рекомендуется менять библиотеку и зависимые моды согласованно, а перед открытием важного мира делать резервную копию. Замена компонентов генерации между запусками может повлиять на новые чанки.

Диагностика установки

При сообщении об отсутствующей зависимости следует проверить название и требуемый диапазон версии в журнале. В папке mods должна оставаться одна подходящая копия YUNG's API. Если игра запускается, но конкретные структуры не появляются, проблему нужно искать уже в конфигурации и совместимости самого worldgen-мода.

Кому пригодится YUNG's API

Игроку библиотека нужна для запуска выбранных проектов YUNG, автору сборки помогает поддерживать согласованный набор worldgen-модов, а разработчику предлагает готовые регистрации, структуры данных и служебные операции. Самостоятельно устанавливать её без зависимых проектов обычно нет смысла.