Unified API

Мод Unified API для Minecraft — кросс-загрузочный API для разработки модов

Unified API — это библиотека, устраняющая необходимость писать отдельный код под Fabric и NeoForge. Она предоставляет унифицированные регистры, события и вспомогательные методы, позволяя разработчикам создавать мультизагрузочные моды. Библиотека включает инструменты для работы с лут-таблицами, биомами, редстоуном, сущностями и интерфейсами, а также утилиты для создания предметов и наборов.

Унифицированные регистры и события

API предоставляет набор Deferred Registries для регистрации контента в любых ванильных или модифицированных реестрах: предметы, блоки, типы сущностей, типы блоков сущностей, творческие вкладки, типы данных компонентов, звуковые события и настройки клавиатуры. Это позволяет избежать специфичных для платформы регистраций.

В библиотеке реализована обширная система событий, объединяющая возможности Fabric и NeoForge. К ним относятся события по умолчанию для данных компонентов, редактирование лут-таблиц (добавление пулов или изменение существующих записей), создание пользовательских команд, события игроков (вход, выход, возрождение), тики (запуск кода в начале/конце цикла клиента), рендеринг интерфейсов (наложение на HUD, крестик прицела), доступ к экранам контейнеров для управления мышью, а также события сервера (запуск, остановка, загрузка datapack, тики уровня).

Вспомогательные методы и компоненты

Для упрощения разработки внедрены вспомогательные методы, обрабатывающие код, специфичный для загрузчиков. Они позволяют реализовать поведение блоков (например, удаление коры с дерева), создавать кастомные частицы, настраивать рендеринг моделей сущностей и блоков с помощью Entity Renderers, привязывать кастомную информацию к тултипам, добавлять пользовательские компоненты к блокам и предметам (например, длительность горения в печи или вероятность компостирования), регистрировать уникальные музыкальные пулы для структур и автоматически масштабировать броню взрослых мобов для их детёнышей.

Библиотека включает компоненты для Furnace Fuel (установка времени горения) и Compost (настройка вероятности компостирования).

Конструкторы контента

Для ускорения создания игрового контента доступны конструкторы (Builders). Equipment Set позволяет быстро создавать инструменты и броню с системой модификации атрибутов и компонентов. Wood Set генерирует все необходимые блоки, предметы и сущности для создания настраиваемых наборов дерева. Block Set избавляет от необходимости вручную создавать вариации каменных или кирпичных наборов.

Также поддерживаются теги с постоянными кулдаунами (Persistent Cooldowns), которые накладывают ограничения на использование предметов между перезагрузками мира для каждого игрока.

Управление биомами и сетевая функциональность

Библиотека предоставляет возможности для модификации биома, аналогичные Fabric Biome API: можно изменять особенности, карверы, эффекты, атрибуты и климат любого биома. Для сетевых взаимодействий реализованы методы регистрации, отправки и обработки пакетов. Также доступны утилиты для работы с ресурс-паками и внутренними данными, а также для проверки информации о модификаторах и инстансах сервера.