YUNG's API: что это и как подобрать версию

Что такое YUNG's API

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

Каким модам она нужна

API используют разные проекты YUNG, но проверять нужно Relations конкретного файла. Требования могут различаться между поколениями Minecraft. Основанием служит manifest модпака или сообщение missing yungsapi. Не устанавливайте библиотеку наугад рядом с любым worldgen-модом: проекты других авторов могут использовать собственные API.

Почему есть несколько страниц

На CurseForge Fabric опубликован отдельно от основной Forge/NeoForge-линейки. Это не разные по смыслу библиотеки, а платформенные сборки одного API. Скачивайте файл со страницы своей платформы. NeoForge также менял размещение между версиями, поэтому используйте ссылку из текущего проекта и фильтр Minecraft, а не старую инструкцию.

Выбор версии

Сопоставьте Minecraft, Fabric, Forge или NeoForge и диапазон, который требует основной мод. Номер API обычно следует поколению игры, но не должен угадываться по памяти. Откройте Files и прочитайте поддерживаемые версии. Для модпака берите релиз из manifest; самый свежий jar может не работать со старой веткой структур.

Установка

Закройте игру и положите один официальный jar в mods активного профиля. Добавьте мод YUNG, который его требует, и дополнительные зависимости из Relations. Не распаковывайте архив. После запуска проверьте latest.log. Если yungsapi зарегистрирован, а структура не появилась, библиотека уже выполнила свою часть — диагностируйте основной проект.

Клиент и сервер

Официальные файлы рассчитаны на клиент и сервер. Для worldgen-мода API обычно требуется серверу, который создаёт чанки; клиенту она нужна, если основной мод объявляет обязательный общий набор. Используйте одинаковые поколения API и мода. Перед добавлением в существующий мир сохраните backup и сначала проверьте тестовую копию.

Структуры не появляются

Новые сооружения чаще генерируются только в ещё не созданных чанках. Убедитесь, что основной мод загружен, его datapack активен и конфигурация не отключает структуру. Создайте тестовый мир или уйдите далеко за исследованную область. YUNG’s API предоставляет общие механизмы, но не управляет частотой каждого зависимого проекта.

Ошибка requires yungsapi

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

Обновление worldgen-сборки

Скопируйте мир, mods, config и datapacks. Обновляйте API и зависимые структуры вместе, затем проверяйте новые чанки в копии мира. При падении откатите всю группу. Частичный апдейт может изменить jigsaw или сериализацию и дать ошибку уже во время генерации, поэтому одного успешного главного меню недостаточно.

Диагностика

Укажите Minecraft, Java, loader, YUNG’s API, основной мод, seed и координаты новых чанков, если проблема связана с генерацией. Для падения приложите полный latest.log или server log и первый caused by. В минимальном профиле оставьте loader, API, один worldgen-мод и его обязательные зависимости.

Быстрая проверка перед началом

yungs api minecraft: Сверь версию игры, загрузчик и зависимости. Добавляй моды небольшими группами и сохраняй журнал, чтобы быстро найти причину вылета.

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