MCAnim

Библиотека для управления анимациями сущностей отображения в мире Minecraft.

Датапак MCAnim предоставляет инструменты для удобного воспроизведения анимаций сущностей отображения (display entities). На данный момент библиотека поддерживает интерполяцию этих сущностей.

В библиотеке реализовано четыре способа запуска анимаций: 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> от имени сущности, которую необходимо анимировать.

Режим rotate принимает компоненты 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] (где w является необязательным), и запустите функцию mcanim:api/maths/quaternion_to_xyz.

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

Какие типы сущностей поддерживаются?
На данный момент библиотека поддерживает интерполяцию сущностей отображения (display entities).

Какие способы воспроизведения анимаций доступны?
Доступны четыре режима: generic, scale, translate и rotate.