Свои предметы и модели

01Из чего состоит предмет

Три слоя, и каждый ломается отдельно:

• Материал — ванильный предмет, которым ваш притворяется для сервера. От него зависит поведение: чем можно копать, что можно надеть, что стреляет.
• Модель — геометрия. Её видит клиент. Приходит в ресурспаке.
• Текстура — PNG, натянутый на модель. Тоже в ресурспаке, и путь к нему прописан внутри модели.

Розовый куб — это «клиент нашёл предмет, но не нашёл модель или текстуру». Не ошибка предмета, всегда ошибка пака.

02Импорт модели

Студия принимает .json (Blockbench / формат Minecraft), .gltf и .glb. Blockbench — самый предсказуемый: он делает ровно то, что понимает Minecraft.

1. Панель Модели → Импорт. Файл сохраняет своё имя — на него ссылаются модель и предмет.
2. Текстуры кладите вместе с моделью в том же импорте. Модель ищет их по относительному пути.
3. После импорта проверьте превью справа. Пусто — геометрия не разобралась; серое — текстура не нашлась.

03Текстуры

• Только PNG. JPG теряет прозрачность и Minecraft его не читает.
• Сторона — степень двойки: 16, 32, 64, 128. 100×100 отрисуется мылом.
• Прозрачность работает, полупрозрачность на предметах — нет: край будет резким.
• Имя файла — латиница, без пробелов. ancient_blade.png — да, Древний клинок.png — нет.

Проверка при сборке пака ловит всё перечисленное и пишет, какой именно файл виноват. Читайте Проблемы — это не предупреждения «на всякий случай».

04Связать с предметом

1. Объекты → ваш предмет → поле Модель → выберите импортированную.
2. Материал оставьте близким по смыслу: меч — iron_sword, шляпа — leather_helmet, безделушка — paper.
3. Сохранить → Ресурспак → Собрать → Применить.
4. Выдать себе и посмотрите в руке от первого и третьего лица.

Модель обязана соответствовать заявленному предмету (пункт 5.3): прозрачная модель на блоке-стене — скрытая подмена, а не дизайн.

05Розовый куб: что проверять

По порядку, сверху вниз — первая же причина обычно и есть ваша:

1. Пак применён, а не только собран. Сборка кладёт файл, применение раздаёт его игрокам.
2. Игрок перезашёл в плейс. Пак приходит на входе.
3. В Проблемы пусто. Одна красная строка = один розовый куб.
4. Имя файла модели не менялось после импорта.
5. Текстура — PNG, латиницей, со стороной в степень двойки.
6. В настройках Minecraft ресурспаки не отключены и не перекрыты вашим личным паком сверху.

06Права на файлы

Загружать чужие модели и текстуры без права на это нельзя — пункт 5.2. Наличие файла в интернете правом не является, и «нашёл на форуме» не аргумент.

• Свои файлы — можно всегда.
• Чужие с лицензией, разрешающей использование, — можно, указав автора в описании плейса.
• Ассеты из платных пакетов и других серверов — нельзя.

Первое нарушение — снятие плейса с публикации, повторное — запрет Студии на 30 дней.