Omitl API: расширенный фреймворк для моддеров Minecraft

Omitl API для Minecraft — экспериментальный фреймворк с интерфейсами для мультиблоков, IK-солверов и шейдеров. Узнайте, как установить и начать работу.

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 откроет доступ к продвинутому рендерингу и анимациям, пусть и с оговоркой на экспериментальность. Если вам близок такой подход, изучите документацию, подключите зависимость и оцените, насколько фреймворк закрывает ваши задачи.