Текстуры и названия предметов

Свой предмет живёт в двух пакетах. Пакет поведения говорит, что предмет делает. Пакет ресурсов говорит, как он выглядит и как называется. На этой странице речь о пакете ресурсов.

Файлы

RP/
  textures/
    item_texture.json
    items/
      ruby.png
  texts/
    en_US.lang

Шаг 1: картинка

Сохрани квадратный PNG, обычно 16x16, в RP/textures/items/. Фон оставь прозрачным.

Шаг 2: короткое имя

item_texture.json связывает короткое имя с PNG. Файл предмета всегда использует только короткое имя.

{
  "resource_pack_name": "My Ruby Add-on",
  "texture_name": "atlas.items",
  "texture_data": {
    "ruby": {
      "textures": "textures/items/ruby"
    }
  }
}

Не пиши .png в конце пути. Для каждого предмета добавь по записи в этот же файл.

Шаг 3: указываем текстуру в предмете

В предмете из пакета поведения компонент minecraft:icon использует короткое имя:

"minecraft:icon": "ruby"

Шаг 4: название

Пока ты не дашь предмету название, игра показывает его id. Добавь строку в языковой файл:

item.wiki:ruby=Ruby

Можно обойтись без языкового файла и задать minecraft:display_name прямо в предмете. Но языковой файл лучше, если потом захочешь перевести аддон.

3D-предметы в руке

Для большинства предметов хватает плоской иконки. Чтобы держать в руке или носить 3D-модель, пакету ресурсов нужен ещё и attachable.