Omitl API
Если вы пишете моды и устали каждый раз заново изобретать регистрацию блоков, анимации или системы рендеринга, обратите внимание на Omitl API. Это экспериментальный фреймворк, который собирает в одном месте десятки готовых интерфейсов и утилит — от датагена до инстансного рендеринга. Ниже разберём, что внутри, кому это нужно и как подключить библиотеку к проекту.
Что такое Omitl API и для кого он создан
Omitl API — это не мод для игрока, а инструмент для разработчиков. Он не добавляет в игру новые предметы или мобы, зато даёт моддерам готовую инфраструктуру: регистрацию контента, системы сущностей, шейдеры, анимации и многое другое. Проект разделён на два подпроекта — Core и Full. Первый намеренно облегчён и содержит только самое востребованное и легко портируемое. Второй включает рендеринг, экспериментальные системы и внутренние утилиты, которые пока нестабильны между версиями.
Фреймворк ориентирован на Fabric и актуален для современных версий Minecraft. Часть систем помечена как WIP: они работают, но их API может измениться. Это стоит учитывать, если вы планируете долгосрочную поддержку своего мода.
Ключевые возможности фреймворка
Core: лёгкая база для повседневной работы
Подпроект Core закрывает рутину, с которой сталкивается каждый моддер. Здесь есть упрощённая регистрация блоков и предметов по шаблону, а также утилиты датагена. Если вам нужно быстро поднять каркас мода без лишних зависимостей, начните именно с Core.
Мультиблоки и системы сущностей
Одна из самых заметных фич — поддержка мультиблоков с кастомными block entity и рендерерами. Структуры могут быть динамически размещаемыми и разрушаемыми, а их размер достигает 27x27x27. Обязательно реализуются направленные грани, но при необходимости можно задать и статичную ориентацию.
Для сущностей предусмотрена система частей по образцу Ender Dragon multipart с дополнительными утилитами, а также улучшенный поиск пути для крупных и быстрых мобов. Отдельно стоит упомянуть IK-солверы — фреймворк инверсной кинематики, который можно прикрепить к чему угодно, включая части моделей.
Рендеринг, шейдеры и анимации
Full-пакет открывает доступ к общим реализациям шейдеров и хукам рендеринга. В списке — инстансный рендеринг объектов, постобработка тумана, SDF-геометрия и пайплайны. Система замены солнца и луны, а также настройка цвета неба и облаков через атрибуты окружения пока находятся в разработке.
Анимационный блок не менее интересен: поддерживаются 3D- и 2D-анимации, хуки для моделей от первого и третьего лица, замена ModelPart с проигрыванием анимаций, а также JSON-ресурсы анимаций с инструментами парсинга Java-моделей. Для сложных эффектов пригодится система частиц на основе сущностей — она легче обычных entity и заметно производительнее.
Как установить и подключить Omitl API
Прежде чем скачать Omitl API, определитесь, нужен ли вам полный пакет или достаточно Core. Для большинства базовых задач хватает второго варианта. Подключение выполняется через build.gradle: добавьте репозиторий Omitl API Maven с ограничением группы org.omitl, а затем укажите зависимость modImplementation для omitl-api или omitl-api-core с переменной версии.
Если вы предпочитаете не возиться с ручной настройкой окружения, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Omitl API можно поставить в один клик, а встроенная проверка совместимости версий подскажет подходящую сборку. После подключения зависимости не забудьте синхронизировать проект в IDE — Gradle подтянет исходники и метаданные автоматически.
Совместимость и ограничения
- Фреймворк рассчитан на Fabric и актуальные версии Minecraft; обратный порт на старые версии не поддерживается.
- Лицензия ARR: свободное использование и распространение разрешены через CurseForge, Modrinth и официальные сайты, в том числе внутри других модов.
- Порты на Forge по умолчанию запрещены — авторы прямо просят не обращаться с такими запросами.
- Перенос отдельных функций вперёд разрешён, приветствуются PR.
Вывод
Omitl API — интересный вариант для тех, кто делает моды на Fabric и хочет сэкономить время на инфраструктуре. Лёгкий Core подойдёт для повседневных задач, а Full откроет доступ к продвинутому рендерингу и анимациям, пусть и с оговоркой на экспериментальность. Если вам близок такой подход, изучите документацию, подключите зависимость и оцените, насколько фреймворк закрывает ваши задачи.