YUNG's API - это библиотека (library mod) для Майнкрафт, от которой зависят все моды серии YUNG: Better Dungeons, Better Strongholds, Better Mineshafts, Better Ocean Monuments и другие. Без неё ни один из этих модов просто не запустится.

Зачем это нужно

Если вы ставите любой мод от YUNG, этот API требуется в первую очередь. Он не добавляет контент сам по себе, но предоставляет общую базу для генерации структур, регистрации блоков и предметов, а также для работы с JSON. По сути - это фундамент, на котором держатся все улучшенные подземелья и крепости.

Что внутри

В API входит несколько полезных механик, которые пригодятся не только для модов YUNG, но и для других разработчиков:

• AutoRegistration (только для 1.18+) - система автоматической регистрации полей через простую аннотацию. Работает независимо от загрузчика модов (Fabric, Forge, NeoForge).
• Улучшенный Jigsaw Manager - переработанная система сборки структур из кусочков (jigsaw). Производительность выше, чем у ванильной версии, плюс добавлены новые типы элементов с дополнительными свойствами. Вживую это можно посмотреть в коде Better Dungeons.
• Новый триггер для поиска структур - если структура не найдена, триггер просто завершается неудачей, а не проходит сразу (как в ванильном Майнкрафт). Это удобно для продвинутых датапаков и модов.
• Интерфейсы для JSON-сериализации - с готовыми адаптерами типов. Упрощает работу с конфигами и сохранениями.
• Утилиты для работы с векторами и колонками - лёгкие, без лишнего веса.
• BlockStateRandomizer и ItemRandomizer - штуки, которые позволяют легко добавить случайный выбор блоков или предметов в ваши структуры. YUNG использует их во всех своих модах.

Для кого это

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

Разработчикам тоже будет полезно - если вы пишете свои моды на генерацию мира, этот API даёт готовые инструменты, которые экономят кучу времени. Код открыт, можно глянуть, как всё устроено, на примере модов YUNG.

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

YUNG's API работает на Fabric, Forge и NeoForge для Minecraft 1.16.5 - 1.21. Версию выбирайте под свою сборку. На Quilt тоже должно работать через совместимость с Fabric API.

Скачайте YUNG's API и забудьте про проблемы с зависимостями - все моды серии будут работать как часы.