Справочник
Структура ресурс-пака Minecraft
Когда пак начинает разрастаться, путаница обычно приходит раньше красоты. Текстуры уезжают не в те папки, модели ссылаются не на те файлы, слои брони получают случайные имена, а новые item definitions из 1.21.4 начинают смешиваться со старыми привычками из эпохи models/item. Эта статья нужна как быстрая рабочая карта: куда что класть, как это называть и что в современных паках считается нормальной структурой.
Папки, которые важны чаще всего
Большая часть практической работы крутится вокруг нескольких папок. Если вы заменяете грань блока, добавляете кастомный предмет, собираете blockstate или выгружаете слои брони, в первую очередь нужны именно эти пути. Когда они стабильны, всё остальное уже складывается гораздо спокойнее.
| Тип | Путь в паке | Пример имени |
|---|---|---|
| Текстура предмета | assets/minecraft/textures/item | diamond_sword.png |
| Текстура блока | assets/minecraft/textures/block | oak_planks.png |
| Модель предмета | assets/minecraft/models/item | custom_diamond_sword_1.json |
| Состояние блока | assets/minecraft/blockstates | crafting_table.json |
| Слой брони | assets/minecraft/textures/models/armor | diamond_layer_1.png |
| Item definition для 1.21.4+ | assets/minecraft/items | diamond_sword.json |
Что изменилось после 1.21.4
Старые гайды часто исходят из того, что вся логика кастомного предмета живёт в models/item и цепочке overrides. Теперь этого уже недостаточно. В новых версиях item definitions переехали в assets/minecraft/items, и именно там часто решается, какую модель или визуальную ветку должен получить предмет.
Это не делает старые папки бесполезными. Текстуры по-прежнему лежат в textures. Модели по-прежнему нужны. Но если вы работаете под 1.21.4+, полезно думать не одной папкой, а тремя слоями сразу: PNG, модель и item definition, которая связывает всё вместе.
Практический порядок сборки
Чаще всего рабочий путь выглядит одинаково. Сначала вы рисуете или экспортируете PNG. Потом кладёте его в правильную папку. После этого подключаете модель или item definition. И только потом проверяете предмет, блок или броню в игре. Когда этот порядок ломается, пак очень быстро превращается в набор почти совпадающих имён и случайных ссылок.
- Подготовить PNG.
- Положить его в нужную папку текстур.
- Создать или обновить JSON-модель.
- Если версия 1.21.4+, собрать файл в
assets/minecraft/items. - Проверить результат в генераторе или прямо в игре.
Какие ошибки встречаются чаще всего
Самые частые проблемы обычно скучные, но от этого не менее дорогие по времени. Блок называют как предмет. JSON смотрит в item/foo, а PNG лежит в textures/block. В имени файла появляются пробелы, заглавные буквы или случайные хвосты. Или путь формально существует, но не совпадает с тем, что вы написали в модели. Безопасная привычка тут простая: использовать lowercase, подчёркивания и один и тот же корень имени для связанных файлов.
Куда идти дальше
Если вам нужна была только карта папок, этого уже достаточно. Если вы прямо сейчас собираете пак, дальше обычно полезнее всего открыть гайд по генератору, статью про CustomModelData и материал по миграции на 1.21.4. Там эта базовая структура уже превращается в команды, предметные кейсы и рабочие схемы подключения.