YUNG's API

Это библиотечный мод, созданный автором YUNG для всех его остальных проектов. Если вы когда-либо устанавливали «Better Dungeons», «Better Strongholds» или «Better Caves», то вы уже косвенно пользовались этой библиотекой. Она не добавляет в игру новых блоков или мобов, но является технической основой, без которой его моды просто не запустятся.

Но самое интересное — этот API может быть полезен не только для модов YUNG. Разработчики, особенно те, кто занимается генерацией мира (worldgen), найдут здесь кучу готовых инструментов, которые избавят от написания шаблонного кода.

Что внутри библиотеки?

Вот ключевые функции, которые предоставляет API:

• AutoRegistration (только для версий 1.18+). Система, позволяющая регистрировать любой объект в игре одной простой аннотацией. Причём работает она независимо от загрузчика модов — будь то Fabric или Forge.
• Кастомная реализация Jigsaw Manager. Это переработанная версия стандартного механизма сборки структур из пазлов. Она работает быстрее ванильной и поддерживает новые типы элементов с дополнительными свойствами. Чтобы увидеть это в деле, загляните в код мода Better Dungeons.
• Новый триггер для критериев. Позволяет безопасно искать любую структуру. Если структура не существует, триггер просто завершится ошибкой, а не пройдёт проверку моментально (как это происходит в ванильном Minecraft).
• Интерфейсы для JSON-сериализации. Упрощают работу с сохранением и загрузкой данных, поставляются со встроенными адаптерами типов.
• Утилиты для работы с математикой. Лёгкие и простые инструменты для расчётов с векторами и позициями колонок блоков.
• BlockStateRandomizer и ItemRandomizer. Два мощных класса для рандомизации блоков и предметов в ваших структурах. С ними добавить случайное появление разных блоков или лута в постройку становится невероятно просто. Автор использует их во всех своих модах.

Если захотите разобраться в деталях, код всех модов YUNG (особенно новых) открыт — можно подсмотреть, как работают те или иные механики. А если что-то останется непонятным, автор предлагает задавать вопросы напрямую в Discord.