ArmorStand

ArmorStand — это модификация для Minecraft версии 1.21.8, которая позволяет заменить стандартную модель игрока на пользовательские внешние модели. Мод находится на стадии активной разработки и уже предлагает впечатляющий набор функций для кастомизации вашего игрового персонажа.

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

Мод поддерживает загрузку моделей в различных популярных форматах: glTF, VRM, PMX и PMD. Также реализована совместимость с моделями сущностей из версии Minecraft для Bedrock Edition, включая незашифрованные модели YSM без упаковки в архив.

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

Любители шейдеров оценят возможность их использования — достаточно изменить настройки рендерера в конфигурации мода.

Как использовать

Для начала работы потребуется подготовить модель, соблюдая авторские права. Разместите файл модели в папке models игровой директории. В самой игре нажмите клавишу I, чтобы открыть настройки мода и выбрать нужную модель.

Управление анимациями осуществляется через интерфейс, вызываемый клавишей K. Здесь можно загружать файлы анимаций (также размещаемые в папке models), регулировать скорость воспроизведения и текущую позицию анимации.

Особенности многопользовательского режима

Для корректного отображения моделей в мультиплеере необходимо установить мод на сервере. Без этого другие игроки не увидят вашу кастомную модель, хотя на вашем клиенте она будет отображаться нормально.

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

Техническая основа: BlazeRod

Основу рендеринга обеспечивает библиотека BlazeRod, написанная на Kotlin и Java. Она поддерживает загрузку моделей форматов glTF, VRM, PMX, PMD и их отображение в игре, а также анимации glTF и VMD.

Библиотека не использует нативные библиотеки и не зависит от конкретной платформы, что обеспечивает широкую совместимость. Хотя BlazeRod распространяется как часть ArmorStand, она может использоваться и отдельно. Однако из-за отсутствия документации и возможных изменений API, её самостоятельное использование в других проектах пока не рекомендуется.

BlazeRod, как и основной мод, распространяется под лицензией LGPL 3.0 или новее. В качестве демонстрации возможностей библиотеки доступен пример мода ball_block, добавляющий в игру сферический блок и распространяемый под лицензией Apache 2.0.