AzureLib

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

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

Что это за библиотека и откуда она взялась

AzureLib представляет собой форк известной библиотеки GeckoLib 4.x. Автор проекта (AzureDoom) взял за основу код ГекоЛиба и начал развивать его самостоятельно, поскольку оригинал по его словам поддерживать и помогать с ним он больше не планирует. Для пользователей это означает одно - обе библиотеки решают одну и ту же задачу, но AzureLib позиционирует себя как актуальную, живую альтернативу с активной поддержкой.

Суть работы движка проста для понимания, но сложна в реализации. Ванильный Minecraft умеет показывать только очень примитивные анимации мобов - пара костей, которые дёргаются по жёстко зашитым алгоритмам. AzureLib позволяет моддерам использовать полноценные 3D-модели из редактора Blockbench (тот самый формат моделей Bedrock-издания) и привязывать к ним детальные покадровые анимации.

Возможности движка анимаций

Набор инструментов у библиотеки вполне взрослый, на уровне профессиональных анимационных фреймворков:

• Сложные 3D-анимации на ключевых кадрах - плавные движения любой части модели, от хвоста дракона до шестерёнок механизма
• Более 30 функций плавности (easing) - движение может ускоряться, замедляться, отскакивать и пружинить, а не просто линейно ползти из точки А в точку Б
• Параллельные анимации - существо может одновременно идти, дышать и поворачивать голову, при этом все анимации не конфликтуют
• Ключевые кадры со звуком и частицами - например, звук топота ровно в момент касания ногой земли или вспышка частиц при ударе
• Событийные ключевые кадры - в нужный кадр анимации можно повесить любую игровую логику через код

Работает всё это практически со всем, что есть в игре: сущности, предметы, броня, блоки. Поэтому моды на AzureLib часто выглядят на голову выше ванилли по плавности и зрелищности.

Для каких версий и загрузчиков доступен

Актуальные ветки библиотеки ориентированы в первую очередь на Minecraft 1.21.1 и 1.20.1 - то есть на самые массовые версии, на которых сегодня собираются модпаки. Поддерживаются все три популярных загрузчика: Fabric (Фабрик), Forge (Фордж) и NeoForge. При установке просто берите файл под свой загрузчик и версию игры, ничего дополнительно настраивать не нужно.

Совет из практики: если при запуске сборки вылетает краш с упоминанием azurelib в логах, проверьте, что версия библиотеки точно совпадает с версией Minecraft и загрузчиком - чаще всего проблема именно в этом. И да, AzureLib и GeckoLib - разные проекты, один не заменяет другой. Если мод требует именно AzureLib, ставте его.

А если вы разработчик модов

Для моддеров подключение стандартное: библиотека добавляется в build.gradle как зависимость, после чего в вашем распоряжении весь анимационный API. Создаёте модель в Blockbench, экспортируете геометрию и анимации, регистрируете рендерер через AzureLib - и сущность или предмет в игре уже живут своей жизнью.

По сравнению с ручным написанием рендера и покадровой математики это экономит недели работы. Весь пайплайн - от модели до звуковых ключевых кадров - уже готов, остаётся только творить. Именно поэтому библиотека стала фактически стандартом для модов с кастомными боссами и анимированным оружием.

Стоит ли скачивать

Итог простой. Игроку - ставить только по требованию других модов, лишним он точно не будет. Разработчику - однозначно стоит присмотреться, если планируете анимированные сущности, броню или предметы: это самый доступный способ получить красивые анимации в Java-версии Minecraft без написания собственного движка. Скачайте AzureLib под свою версию игры - и сборка заработает как надо.