Свой предмет в Blockbench

Схема собственного Java-предмета: проект Blockbench, модель и PNG, определение items с ссылкой на models, выдача палки с item_model.

1. В Blockbench создайте Java Block/Item, назовите проект test_item. Generic Model и Bedrock Model предназначены для других экспортов.
2. Добавьте два-три куба в пределах обычного пространства 0–16 по каждой оси. Для первой модели используйте простой силуэт без поворотов и тонких пересекающихся граней.
3. Сохраните проект как test_item.bbmodel. Дальнейший экспорт не заменяет исходник: он нужен, чтобы менять геометрию и UV без восстановления проекта из игрового JSON.

Создайте небольшую PNG-текстуру, например 32×32, разложите UV и закрасьте разные части разными цветами. Проверьте модель со всех сторон: необработанная нижняя грань часто заметна только в руке. Экспортируйте PNG отдельно, не оставляйте единственную копию внутри .bbmodel.

В Display Mode настройте отображение в GUI и руках. Это параметры показа предмета, а не изменение размеров самих кубов. Сначала сделайте читаемый вид в инвентаре, затем проверьте первую и третью персону. Экспортируйте Java block/item model JSON как test_item.json.

Создайте папку JuxMC-Test в resourcepacks игрового профиля. На её верхнем уровне должны находиться pack.mcmeta и assets, без лишней внешней папки. Все имена ресурсов пишите латиницей в нижнем регистре.

Положите экспортированный model JSON в models/item, а PNG в textures/item своего пространства juxmc. В поле textures экспортированной модели проверьте ссылку juxmc:item/test_item без расширения .png и без абсолютного пути Windows. Сохраните существующие номера текстур, на которые ссылаются faces.

Структура папок

JuxMC-Test/
  pack.mcmeta
  assets/juxmc/items/test_item.json
  assets/juxmc/models/item/test_item.json
  assets/juxmc/textures/item/test_item.png

pack.mcmeta для Minecraft 1.21.4

{
  "pack": {
    "pack_format": 46,
    "description": "JuxMC: учебный предмет"
  }
}

Создайте отдельный assets/juxmc/items/test_item.json с примером ниже. Файл из items выбирает способ отображения и указывает на геометрию из models. Это два разных JSON с одинаковым именем в разных каталогах.

Значение juxmc:item/test_item указывает на assets/juxmc/models/item/test_item.json. Компонент juxmc:test_item, который будет у самой палки, указывает на assets/juxmc/items/test_item.json. Эта разница помогает найти ошибку пути без случайного переименования всех файлов.

assets/juxmc/items/test_item.json

{
  "model": {
    "type": "minecraft:model",
    "model": "juxmc:item/test_item"
  }
}

1. В Minecraft 1.21.4 включите ресурспак. В тестовом мире с разрешёнными командами выполните команду ниже.
2. Осмотрите предмет в инвентаре, от первого лица, от третьего лица и в рамке. Проверьте маленький размер GUI: красивый крупный вид в Blockbench не гарантирует читаемую иконку.
3. После правки файлов перезагрузите ресурсы F3+T и повторите проверку. При ошибке посмотрите latest.log: там обычно указан конкретный не найденный ресурс или неверный JSON.
4. Храните отдельно исходный .bbmodel и готовую папку/ZIP ресурспака. В ZIP на верхнем уровне должны оставаться pack.mcmeta и assets.

Команда для Java 1.21.4

/give @s minecraft:stick[minecraft:item_model="juxmc:test_item"]

Minecraft: Java Edition строго 1.21.4 для примеров ниже. Версия: Blockbench 5.2.2; формат проекта Java Block/Item. Установка: Ванильный ресурспак, без Fabric/Forge. pack_format для ресурспака 1.21.4 — 46. В 1.21.4 введены определения в assets/<namespace>/items и выбор через minecraft:item_model. Старые примеры с overrides и CustomModelData нельзя переносить сюда без адаптации. Файл .bbmodel — исходник редактора; игра использует экспортированный model JSON и PNG. Для урока кубы не вращаются: возможности новых экспортёров не следует автоматически переносить на 1.21.4.

• Blockbench 5.2.2: официальный релиз
• Blockbench Wiki: Formats
• Blockbench Wiki: Overview & Tips
• Mojang: Minecraft Java Edition 1.21.4, Resource Pack Version 46 и Item Models

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

• Как пользоваться Litematica
• Как пользоваться Axiom
• Свой мир в WorldPainter
• Лаунчер JuxMC
• Как создать сервер

Весь раздел

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