PlayerAnimator — это библиотека для моддеров, предназначенная для добавления пользовательской анимации к моделям персонажей в Minecraft с помощью файлов ключевых кадров. Этот мод для Minecraft работает как с Fabric, так и с Forge и направлен на обеспечение максимальной совместимости с другими расширениями, избегая помех в работе существующих систем.
Эта библиотека, разработанная как технический слой, не вносит прямых изменений в игру, но позволяет другим модам добавлять сложные и реалистичные движения для управляемого персонажа. Для моддеров она открывает путь к плавной анимации всего тела, включая эффекты изгиба рук и ног, через bendy-lib . Для конечного пользователя она невидима, но является ключевым элементом многих продвинутых проектов.
Возможности мода PlayerAnimator
Библиотека, предназначенная для сложных анимаций
PlayerAnimator использует систему наложения анимаций: каждое действие может запускать определённую анимацию, а некоторые из них могут накладываться друг на друга с разными приоритетами. Этот принцип позволяет комбинировать несколько эффектов без конфликтов, например, походку с жестом руки.
- Модульная структура : каждая часть тела (голова, руки, ноги, туловище и все «тело») может быть анимирована независимо.
- Совместимость с GeckoLib и Emotecraft : файлы анимации из этих форматов можно использовать напрямую.
- Поддержка замедления : распознаются все кривые перехода easings.net , что позволяет добиться естественной визуализации движений.
- Bendy-lib (необязательно) : если вы добавите это, конечности смогут сгибаться более реалистично, в середине своего сегмента.
Доступный формат анимации
Анимации можно создавать в Blockbench (с соблюдением определённых правил наименования) и затем экспортировать в формате JSON. Также возможна динамическая загрузка из папки assets/modid/player_animation/. После загрузки анимацию можно воспроизвести через систему KeyframeAnimationPlayer.
Моддеры имеют доступ к таким слоям ModifierLayerдля добавления эффектов, управления переходами или объединения нескольких анимаций без создания конфликтов.
Совместимость с несколькими версиями
PlayerAnimator работает как в Forge , так и в Fabric и разработан так, чтобы не нарушать работу других установленных библиотек. Важно никогда не включать его в свой собственный мод через затенение , так как это может нарушить работу всей системы анимации.
Более продвинутые пользователи также могут использовать anim-coreнезависимый от Minecraft мод для создания инструментов или экспорта/импорта анимаций без зависимости от игры.
Использование мода PlayerAnimator
Если вы просто хотите использовать мод, который использует PlayerAnimator , просто поместите его файл .jarв свой mods.
Для разработчиков модов интеграция зависит от вашей среды:
- В разделе Fabric : добавьте
player-animation-lib-fabricсвои зависимости через Maven .
- На Forge : используйте
player-animation-lib-forge, следуя конкретным инструкциям ForgeGradle, в частности для управления миксинами. - Вы также можете включить опцию
bendy-libдля доступа к более плавной анимации.
Примеры проектов для Forge и Fabric доступны на официальной странице GitHub .
