MCAnim - Библиотека анимаций для Minecraft от Gears

MCAnim представляет собой библиотеку в виде датапака для Minecraft, которая значительно упрощает создание и воспроизведение различных анимаций в игровом мире. На текущий момент поддерживается интерполяция для отображаемых сущностей, но в будущих версиях планируется добавить функционал для работы с частицами.

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

Воспроизведение анимаций

Система предлагает четыре типа анимаций: generic, scale, translate и rotate. Универсальный метод generic позволяет одновременно применять несколько анимационных эффектов, включая изменение продолжительности. Для использования необходимо выполнить команду data modify storage mcanim:api/display_animation/generic animation set value {}, заменив фигурные скобки на нужные параметры. Здесь можно задать свойство duration, определяющее длительность анимации, а остальные свойства будут обработаны как анимационные параметры.

Методы scale и translate работают аналогично, но принимают параметры x, y и z. Функция rotate предварительно преобразует значения x, y и z в кватернионы. После настройки параметров запустите функцию mcanim:api/display_animation/<function> для целевой сущности, чтобы увидеть анимацию в действии.

Работа с вращением и кватернионами

Функция вращения принимает компоненты x, y и z в градусах, но поскольку Minecraft использует кватернионы для представления вращения, система автоматически преобразует углы в соответствующий формат. Это преобразование можно выполнить вручную, установив mcanim:api/maths/xyz_to_quaternion target в значение {x, y, z} или [x, y, z] с нужными параметрами, а затем запустив функцию mcanim:api/maths/xyz_to_quaternion. Результат будет доступен в mcanim:api/maths/xyz_to_quaternion output.

Также доступна обратная операция - преобразование кватерниона в компоненты x, y и z. Однако важно отметить, что эта функция в настоящее время работает некорректно и выдает неточные значения, поэтому её использование не рекомендуется. Для выполнения преобразования установите mcanim:api/maths/quaternion_to_xyz target в [x, y, z, w] или {x, y, z, w} (параметр w игнорируется и является необязательным), затем выполните function mcanim:api/maths/quaternion_to_xyz. Полученный массив [x, y, z] будет находиться в mcanim:api/maths/quaternion_to_xyz output.

Это все функции, реализованные на данный момент.