Практическое руководство

Свой аватар Figura

Загрузите готовый аватар Figura, создайте собственную модель Blockbench и запустите анимацию через Lua. Настройте публикацию, видимость и разрешения других игроков.

На странице 12 разделов

Коротко

Начните с готового аватара Figura: так вы проверите установку и папку профиля. Затем создайте собственную заготовку, измените модель в Blockbench и добавьте короткую анимацию через Lua. Публикация для других игроков выполняется после локальной проверки.

FirstAvatar: avatar.json, model.bbmodel и script.lua; анимация idle запускается через animations.model.idle:play().

Схема примера

Папка Figura содержит avatar.json, model.bbmodel и script.lua. Аксессуар в группе Head следует голове. Анимация idle с Loop запускается вызовом animations.model.idle:play().

Учебный аватар Figura: файлы аватара, аксессуар в Head, цикл idle и запуск из script.lua. Проверяйте локальную версию перед Upload.

Проверьте готовый аватар

Откройте мир, нажмите паузу и кнопку Figura с треугольником. Из меню мода откройте папку аватаров. Её путь — figura/avatars внутри каталога текущего игрового профиля; у отдельной сборки лаунчера это может быть другая папка, чем основная .minecraft.

Скопируйте готовый аватар в эту папку как каталог или ZIP. Внутри самого аватара должен находиться avatar.json. Если архив распакован в две вложенные папки, выберите внутреннюю с этим файлом. Загрузите аватар из списка и проверьте его вид от третьего лица. Пока оставьте его локальным.

Минимальная структура учебного аватара

figura/avatars/FirstAvatar/
  avatar.json
  model.bbmodel
  script.lua

Создайте собственную заготовку

В меню Figura нажмите плюс, задайте имя и включите Include a Model и Include a Script. Для полной замены персонажа выберите Player Model. Создание откроет папку с avatar.json и выбранными файлами.

avatar.json объединяет файлы; минимальное содержимое — {}. Файлы .bbmodel загружаются как модели, .lua — как скрипты. Используйте model.bbmodel и script.lua для короткого обращения в коде.

Измените модель в Blockbench

Откройте model.bbmodel в настольном Blockbench. Требуется Generic Model; Java Block/Item и Bedrock Model не подходят. Для преобразования выберите File → Convert Project и Generic Model.

Добавьте аксессуар в группу Head, чтобы он следовал голове. Figura распознаёт специальные имена ParentTypes, включая Head и Body. Назначьте кубам текстуру и сохраните модель в папку аватара. PNG, не зарегистрированная в .bbmodel, сама не подключится.

Для полной замены тела используйте Hide Vanilla Player в мастере. Для аксессуара сохраните обычного персонажа. До анимации проверьте текстуру и следование головы.

Запустите первую анимацию через Lua

В Animate создайте анимацию idle, включите Loop и задайте небольшой поворот отдельной группы аксессуара. Сделайте одинаковую позу в начале и конце, например на отметках 0 и 2 секунды, а промежуточную — на 1 секунде. Сохраните .bbmodel вместе с анимацией.

Добавьте вызов ниже в script.lua. model — имя файла без .bbmodel, idle — точное имя анимации с учётом регистра. Для запуска цикла достаточно одного вызова play; не вызывайте его заново каждый кадр. В выражениях анимации Figura использует Lua, а не Molang. Для первого результата оставьте ключевые кадры обычными числами.

script.lua для model.bbmodel с анимацией idle

animations.model.idle:play()

Отличайте локальную версию от опубликованной

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

Проверьте готовую модель и нажмите Upload. Второму игроку нужны Figura и соединение с backend. Проверяйте результат со второго клиента. Reload возвращает опубликованный вариант и не публикует новые локальные изменения.

Проверьте видимость и разрешения

Разрешения Figura определяют видимость чужих аватаров у вас. Ваше доверие другу не повышает его разрешения для вашего аватара. Серверный OP эти настройки не заменяет.

Наведение на щит у имени показывает заблокированные возможности, красный крест — ошибку скрипта. Проверяйте конкретную причину и повторяйте тест. Облачная видимость зависит от корректного UUID: offline-mode сервер может нарушать соответствие аккаунта аватару.

Если не работает

ПроблемаЧто проверить
Готовый аватар не появился в спискеПроверьте figura/avatars текущего профиля и наличие avatar.json внутри выбранного каталога или ZIP. Уберите лишнюю внешнюю папку после распаковки.
Модель есть в Blockbench, но Figura её не загружаетПроверьте формат Generic Model и расширение .bbmodel. Затем посмотрите ошибку в меню Figura: формат проекта и файл текстуры — разные причины.
В коде animations.model.idle значение nilСверьте имя model.bbmodel и точное имя idle. Для файла в подпапке путь модели также меняется; начните с файлов в корне аватара.
Сохранённые изменения исчезают после ReloadReload возвращает опубликованный аватар. Выберите локальную папку для редактирования, а готовые изменения загрузите через Upload.
У друга аватар выглядит иначеПроверьте установленную Figura, соединение с backend, последнюю публикацию и разрешения клиента друга. Наведение на щит или красный крест уточнит причину.
Есть конфликт с Immersive Portals или рендеромFigura 0.1.6 отмечает конфликты с Immersive Portals, Canvas и ImmediatelyFast. Для первого аватара используйте отдельный профиль без этой комбинации.

Источники и версии

Minecraft Java Edition 1.20.1, Fabric Loader 0.14.25 или новее, Figura 0.1.6+1.20.1 для Fabric, Java 17 или новее. Проверены метаданные соответствующего JAR. Базовые разделы официальной вики помечены как 0.1.5; описанный формат аватара и вызов animations сохранены в 0.1.6. Это клиентский мод. В метаданных заявлен конфликт с Immersive Portals, Canvas и ImmediatelyFast.

Справка сверена 31 октября 2026 года. Перед установкой выбирайте файл для своей версии игры и загрузчика.

Частые вопросы

Нужна ли Figura на сервере?

Для обычной облачной системы аватаров это клиентский мод. Видеть аватары должны клиенты с установленной Figura.

Зачем нужен Lua, если анимация уже в Blockbench?

Blockbench хранит кадры. Скрипт Figura сообщает, какую анимацию и когда запускать; один цикл можно запустить единственной строкой.

Можно ли менять модель без повторного Upload?

Локально — да. Другие игроки получают опубликованную копию, поэтому готовое обновление нужно загрузить в облако отдельно.

Связанные руководства

Сверено по официальной документации авторов. Совместимость указана для примера на странице.