Hybrid API [HAPI]

Hybrid API (HAPI) - библиотечный мод для Майнкрафт от команды Hybrid Labs. Если вы поставили к себе хоть один их проект - например, Hybrid Aquatic с его морскими существами - то эта библиотека у вас уже есть в зависимостях. Она не добавляет контент сама по себе, но держит на себе всю экосистему модов студии.

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

По сути, HAPI - это общая кодовая база, которую Hybrid Labs вынесли в отдельный проект. Внутри неё весь повторяющийся код их модов: регистрация существ, рендер через GeckoLib, общие системы поведения и прочее. Без такого подхода каждый мод тянул бы за собой копии одних и тех же классов, а это баги, конфликты и лишний вес.

Кроме того, Hybrid API решает классическую проблему совместимости. В библиотеку встроен набор тегов для биомов, предметов и сущностей - по ним моды Hybrid Labs и сторонние аддоны понимают друг друга. Если два аддона используют стандарт HAPI, они не конфликтуют, а дополняют друг друга. Для игрока на выживании это означает просто: морские мобы спавнятся там, где им положено, и не ломают чужие механики.

Что можно сделать с HAPI

Главная фишка библиотеки - она открыта для сторонних разработчиков. На базе кода HAPI можно писать собственные аддоны уровня официальных проектов студии:

• Морские существа - рыбы, крабы, глубоководная живность в духе Hybrid Aquatic
• Птицы - новые виды пернатых с анимациями от GeckoLib
• Водный транспорт - лодки, корабли и прочие watercraft
• Еда и предметы в связке с Hybrid Delights

Мод распространяется по лицензии MIT, так что код можно спокойно использовать и изучать. Это редкость: многие библиотеки закрыты или ограничены, а тут разработчики прямо приглашают делать аддоны. Если вы когда-то хотели добавить в игру свою рыбу, которая ведёт себя как мобы из Hybrid Aquatic - это тот самый инструмент.

Проекты, зависящие от Hybrid API

• Hybrid Aquatic - океанические биомы и морские существа
• Fantastic Fishery - рыбалка и всё, что с ней связано
• Hybrid Delights - кулинария на основе морепродуктов
• Hybrid Birds - птицы для вашего мира
• Fish N' Ships - морские приключения и транспорт

Ставить HAPI отдельно смысла нет - лаунчер подтянет его автоматически вместе с любым из этих модов. Но полезно понимать, что если после обновления что-то из экосистемы перестало работать, виноват часто именно он, а не сам контентный мод.

Зависимости

Для работы библиотеке нужны следующие моды:

Forge / NeoForge:

• Kotlin for Forge
• GeckoLib

Fabric:

• Fabric API
• Fabric Language Kotlin
• GeckoLib

Версии и совместимость

Hybrid API поддерживает Minecraft Java Edition 1.20.1 и 1.21.1 на Fabric, Forge и NeoForge. Клиентская и серверная стороны обе поддерживаются, так что библиотека подойдёт и для одиночной игры, и для сервера. На Modrinth проект уже набрал больше 21 тысячи загрузок - для библиотеки неплохой показатель, он косвенно говорит о популярности самих модов Hybrid Labs.

Важные нюансы

Стабильность аддонов напрямую зависит от версии HAPI. Перед обновлением экосистемы проверяйте, что аддоны, которые вы используете, уже обновлены под свежую версию библиотеки. В патче 1.1.2 для Fabric на 1.21.1, например, чинили неприятный баг - маленькие водные мобы вроде летающей рыбы становились невидимыми на близком расстоянии. Типичная мелочь для библиотек, но если бы вы не обновились, могли бы долго гадать, куда пропала рыба.

Короче: скачивать Hybrid API стоит всем, кто играет с модами Hybrid Labs - сам по себе он ничего не меняет, но без него ничего не заведётся, а с ним весь зоопарк морских существ, птиц и кораблей работает как единый организм. Разработчикам аддонов это must-have.