На странице 12 разделов
Коротко
Начните с готового аватара Figura: так вы проверите установку и папку профиля. Затем создайте собственную заготовку, измените модель в Blockbench и добавьте короткую анимацию через Lua. Публикация для других игроков выполняется после локальной проверки.
FirstAvatar: avatar.json, model.bbmodel и script.lua; анимация idle запускается через 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 для короткого обращения в коде.
Откройте 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 в мастере. Для аксессуара сохраните обычного персонажа. До анимации проверьте текстуру и следование головы.
В 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. Для файла в подпапке путь модели также меняется; начните с файлов в корне аватара. |
| Сохранённые изменения исчезают после Reload | Reload возвращает опубликованный аватар. Выберите локальную папку для редактирования, а готовые изменения загрузите через 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.
- FiguraMC: авторский релиз 0.1.6
- FiguraMC: формат и папка аватара
- FiguraMC: создание аватара в мастере
- FiguraMC: Generic Model, текстуры и настройки Blockbench
- FiguraMC: запуск анимаций через animations API
- FiguraMC: публикация, разрешения и multiplayer
- Figura 0.1.6+1.20.1 Fabric: авторский JAR и метаданные зависимостей
- Figura 0.1.6: действия Upload и Reload в WardrobeScreen
- Figura 0.1.6: клиентские категории разрешений
Справка сверена 31 октября 2026 года. Перед установкой выбирайте файл для своей версии игры и загрузчика.
Нужна ли Figura на сервере?
Для обычной облачной системы аватаров это клиентский мод. Видеть аватары должны клиенты с установленной Figura.
Зачем нужен Lua, если анимация уже в Blockbench?
Blockbench хранит кадры. Скрипт Figura сообщает, какую анимацию и когда запускать; один цикл можно запустить единственной строкой.
Можно ли менять модель без повторного Upload?
Локально — да. Другие игроки получают опубликованную копию, поэтому готовое обновление нужно загрузить в облако отдельно.
- Общий чат DiscordSRV
- Настройка BlueMap
- Порталы Immersive Portals
- Свой предмет в Blockbench
- Как сделать скин
- Лаунчер JuxMC
- Как создать сервер
Сверено по официальной документации авторов. Совместимость указана для примера на странице.