Ваш первый предмет

В этом гайде вы сделаете Рубин: простой блестящий самоцвет, который складывается в стопки по 64, появляется в творческом инвентаре и имеет своё название и значок. Пока он ничего особенного не умеет, но каждый меч, еда или броня, которые вы сделаете потом, начинаются именно с этого файла.

Сделать его можно двумя способами. Быстрый займёт пару минут на телефоне. Ручной покажет вам каждый файл, чтобы вы понимали, что происходит.

Быстрый способ: GodCraft

GodCraft сам создаёт файл предмета, текстуру, название и файлы пакета. Вам не придётся открывать ни одного JSON-файла.

1. Откройте Мастерскую и добавьте в свой аддон Предмет.
2. Нарисуйте значок в пиксельном редакторе или возьмите ванильную текстуру и перекрасьте её.
3. Введите название и выберите нужные настройки, например размер стопки.
4. Нажмите Экспорт. GodCraft запишет манифесты, UUID и языковые файлы и выдаст .mcaddon, который можно открыть в Minecraft.

Интересно, что внутри этого .mcaddon? Читайте дальше.

Вручную

Вам нужны уже настроенные пакет поведения (BP) и пакет ресурсов (RP). Если их ещё нет, сначала пройдите Настройку проекта. Во всех примерах мы используем пространство имён myname. Замените его на своё короткое имя маленькими буквами везде, где оно встречается.

Вот файлы, которые вы создадите или измените:

Шаг 1: файл предмета

Создайте в пакете поведения папку items и добавьте в неё этот файл:

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "myname:ruby",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "myname_ruby"
        }
      },
      "minecraft:display_name": {
        "value": "item.myname:ruby.name"
      },
      "minecraft:max_stack_size": 64
    }
  }
}

Разберём его по частям.

• format_version говорит игре, по какой версии правил для предметов написан файл. Используйте свежую, чтобы работали все современные компоненты.
• identifier - уникальный ID предмета. Он всегда выглядит как namespace:name. Никогда не используйте пространство имён minecraft для нового предмета: оно принадлежит игре.
• menu_category решает, где предмет появится в творческом инвентаре. category может быть construction, nature, equipment, items или none (скрыт). Ещё можно добавить group, например "minecraft:itemGroup.name.sword", чтобы положить его в уже существующую папку.
• components - место, где предмет получает свои возможности. Каждый компонент - одна возможность.

Здесь используются три компонента:

• minecraft:icon выбирает картинку. default - это короткое имя, которое вы зададите в item_texture.json на шаге 3, а не путь к файлу.
• minecraft:display_name задаёт название. Здесь оно указывает на ключ в языковом файле, чтобы название можно было перевести.
• minecraft:max_stack_size - сколько штук помещается в один слот. Число от 1 до 64.

Шаг 2: текстура

Нарисуйте PNG размером 16x16 пикселей и сохраните его в пакете ресурсов:

A 16x16 PNG with a transparent background

Оставьте фон прозрачным, иначе значок будет квадратом. Если вы новичок в пиксель-арте, в гайде Пиксельные текстуры есть советы, как сделать маленькие картинки красивыми.

Шаг 3: зарегистрируйте текстуру

Игра не читает PNG-файлы по пути прямо из предмета. Вместо этого item_texture.json даёт каждой картинке короткое имя, и предмет использует это имя. Создайте (или откройте) этот файл:

{
  "resource_pack_name": "myname",
  "texture_name": "atlas.items",
  "texture_data": {
    "myname_ruby": {
      "textures": "textures/items/ruby"
    }
  }
}

Обратите внимание на две вещи:

1. Ключ myname_ruby совпадает со значением default в компоненте значка предмета.
2. В конце пути нет .png.

Когда будете добавлять новые предметы, кладите их все в этот же файл как дополнительные записи внутри texture_data. Не создавайте второй item_texture.json.

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

Откройте (или создайте) английский языковой файл и добавьте одну строку:

item.myname:ruby.name=Ruby

Часть до = должна в точности совпадать с value из minecraft:display_name. Часть после него - это то, что видят игроки. Lang-файлы - обычный текст: одна запись на строку, без кавычек и запятых.

Шаг 5: проверьте

1. Скопируйте оба пакета в Minecraft или экспортируйте их (смотрите Экспорт и установка).
2. Создайте новый мир и включите оба пакета в его настройках.
3. Откройте чат и введите команду /give:

/give @s myname:ruby 64

Вы должны получить полную стопку рубинов с вашим значком и названием "Ruby". В творческом мире он также найдётся во вкладке Предметы инвентаря.

Если что-то не работает

Включите Content Log в настройках для авторов в Minecraft, чтобы видеть точные сообщения об ошибках. Другие решения есть в разделе Когда что-то сломалось.

Что дальше?

Ваш рубин - простой предмет. Теперь дайте ему работу:

• Сделайте что-нибудь съедобное по гайду Своя еда.
• Превратите рубины в меч или кирку в гайде Оружие и инструменты.
• Сделайте полный комплект рубиновой брони в гайде Своя броня.
• Дайте игрокам крафтить рубины с помощью гайда Рецепты крафта и печи.

Чтобы увидеть, как Mojang делает свои предметы, загляните в ванильные предметы.