Unified API

Unified API

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

Unified API предоставляет собственные регистры, события и вспомогательные методы, которые заменяют платформенно-специфичный код. Всё, что нужно - подключить Fabric API (для Fabric) или базовый NeoForge (для NeoForge). Никаких лишних зависимостей.

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

Обычно, чтобы мод работал и на Fabric, и на NeoForge, приходится писать два набора кода или использовать сложные прослойки. Unified API берёт эту боль на себя: вы пишете один раз, а он сам подставляет нужные реализации под каждый загрузчик. Экономия времени и нервов - колоссальная.

Основные возможности

Регистры (Registries)

• Deferred Registry - отложенная регистрация контента для любых ванильных или модных реестров.
• Items, Blocks, Entity Types, Block Entity Types, Creative Tabs, Data Component Types, Sound Events, Key Mappings - всё, что нужно для регистрации.

Хелперы (Helpers)

• Platform - проверка модов, загрузчика и другой информации об окружении.
• Packs - регистрация внутренних датапаков и ресурспаков.
• Creative Entries - вставка предметов в креативные вкладки.
• Networking - регистрация, отправка и обработка пакетов.
• Biome Modifications - аналог Fabric Biome API: легко меняйте фичи, карверы, эффекты, атрибуты и климат любого биома.
• Block Conversions - кастомное поведение при замене блоков (например, обстругивание брёвен).
• Particle Providers - создание кастомных частиц на клиенте.
• Entity Renderers - настройка рендеринга для кастомных сущностей и блок-сущностей.
• Tooltips - привязка кастомных тултипов (как у bundles).
• Data Components - добавление кастомных компонентов к блокам/предметам (топливо для печи, компост и т.п.).
• Structure Music - регистрация уникальных музыкальных треков для структур.
• Legacy Baby Armor - автоматическое масштабирование брони для малышей-мобов без отдельных текстур.

События (Events)

• Default Data Components - фильтрация и изменение стандартных компонентов предметов.
• Loot Tables - добавление новых пулов в таблицы добычи или редактирование существующих.
• Commands - создание кастомных команд.
• Players - код на события игрока (вход/выход/возрождение).
• Ticks - код в начале/конце клиентских тиков (например, для кастомных клавиш).
• Guis - рендеринг HUD (прицел, хотбар).
• Screens - доступ к AbstractContainerScreen для кастомного поведения мыши.
• Servers - код на старт/стоп сервера, загрузку датапаков, серверные тики и тики уровней.

Компоненты (Components)

• Furnace Fuel - задайте длительность горения для любого предмета.
• Compost - сделайте предмет компостируемым с заданным шансом.

Билдеры (Builders)

• Equipment Set - инструменты и броня с продвинутой системой компонентов и атрибутов.
• Wood Set - полный набор блоков, предметов и сущностей для кастомных древесных пород.
• Block Set - чтобы не создавать отдельно каменный или кирпичный набор.

Теги (Tags)

• Persistent Cooldowns - принудительные кулдауны на предметы для каждого игрока, сохраняющиеся между загрузками мира.

Почему стоит выбрать Unified API?

• Нет брейкинг-изменений в рамках одной версии Minecraft - обновления безопасны.
• Полная документация и миграционные гайды при переходе между версиями.
• Консистентные порты на новые версии - фичи сразу заточены под них.
• Экономия времени - билдеры для быстрого создания вудсетов, инструментов, брони.
• Мощные события вроде Loot Table, Default Data Component и Biome Modification.

Если вы разрабатываете моды для Майнкрафт и хотите, чтобы они работали и на Fabric, и на NeoForge без лишних танцев с бубном - Unified API ваш выбор. Скачайте Unified API и забудьте о платформенной несовместимости.