AnimationJS - скриптовые анимации игроков в Minecraft

AnimationJS - аддон для KubeJS, который отдаёт скриптерам власть над анимациями игроков. Сам по себе он в игру ничего не добавляет. Это инструмент для тех, кто пишет скрипты и собирает сборки модов. Но если руки дошли до KubeJS, открываются вещи, которые раньше требовали полноценного Java-мода.

Раньше, чтобы заставить персонажа махнуть рукой при входе на сервер или сесть по команде, приходилось писать свой мод. Теперь хватит пары строк скрипта. Анимации идут через playerAnimator - библиотеку, на которой держится большинство анимационных проектов в Майнкрафт. AnimationJS просто связывает её с KubeJS и даёт понятный API.

Зайдёт это в первую очередь авторам сборок модов, админам ролевых серверов и всем, кто любит ковырять KubeJS. Если вы просто играете и ставите готовые проекты из каталога - проходите мимо, вам нужен контент, а не конструктор. А вот если хочется уникальных механик для своего сервера, это как раз тот случай. По сути AnimationJS - это техническая утилита для моддинга и кастомизации анимаций, а не хоррор, не PvP-пак и не что-то визуальное из коробки.

Что умеет AnimationJS

• Серверные анимации от любого объекта игрока. Запустил один раз - видят все вокруг, а не только ты сам.
• Динамическая правка частей модели через событие AnimationJS.playerModel(). Меняй размер, положение и вид кусков скина, делай превращения и кастомные позы.
• Рендер через клиентское событие AnimationJS.playerRenderer(). Классика - вывод предмета на модели игрока.
• Проигрывание анимаций через playerAnimator.
• Поддержка GeckoLib-анимаций. Подтягиваются через LioLib, зависимость опциональная.
• Universal Animation Controller - контроллер, в котором условия для анимаций задаются без боли и костылей.

Это не про эмоции, которые игрок выбирает вручную из меню. Здесь анимация запускается по условию, которое прописал скрипт: вход на сервер, получение предмета, нажатие клавиши, низкое здоровье, что угодно. Отсюда и типичные сценарии - катсцены в квестах, реакции на события, кастомное поведение персонажа в ролевых сборках.

Зависимости

Без них ничего не заведётся:

• KubeJS
• playerAnimator
• Lio's Player Animator API

Последний - форк Zigy's Player Animator API. Если вы уже работали с оригиналом, синтаксис будет знакомым, переучиваться не придётся.

Версии и загрузчики

Версия Minecraft	Загрузчики	Актуальный релиз
1.20.1	Forge, NeoForge	animationjs-1.20.1-0.1.3
1.19.2	Forge	0.1.0

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

Важные нюансы

Мод ничего не делает сам по себе. Поставили - и в игре не изменилось ровным счётом ничего. Пока не написан скрипт, AnimationJS просто висит в фоне и ждёт вызовов. Не пугайтесь этого, так и задумано.

Свежий релиз 1.20.1 починил пару неприятных багов: сохранение старых событий в UniversalController и ошибку с расширением доступа. Если вы сидели на более ранней сборке и ловили странности с контроллером анимаций, обновление стоит поставить.

Совет по отладке. Скрипты KubeJS любят молча падать. Ошибку ищите в логе, а не в игре - в чат ничего не прилетит. Начинайте с одной простой анимации на вход, убедитесь, что она видна другим игрокам, и только потом наворачивайте условия.

Про производительность. Анимации считает сервер, а рендерит клиент. На FPS это влияет слабо, но если на экране двадцать одновременно анимированных игроков, слабое железо может просесть. Тут всё зависит от того, сколько сущностей вы крутите в кадре.

Совместимость. AnimationJS работает поверх playerAnimator, поэтому конфликтов с оптимизационными модами вроде Sodium не ждём - это разная плоскость. А вот другие проекты, которые тоже лезут в модель игрока, могут спорить за одни и те же части скина. Проверяйте на тестовом мире.

Итог

AnimationJS - узкий, но очень полезный инструмент. Он не для рядового игрока, а для тех, кто собирает сборку модов или крутит сервер с кастомными механиками. Проект уже набрал около 175 тысяч скачиваний, так что база у него живая, а вопросы почти всегда решаются через сообщество KubeJS-скриптеров.

Скачать AnimationJS стоит, если вы работаете с KubeJS и хотите оживить персонажей без написания собственного мода. Для Minecraft 1.20.1 и 1.19.2, на Forge или NeoForge - ставится быстро, а дальше всё зависит от вашей фантазии и умения писать скрипты.