Введение: ваш сервер — ваши правила

ItemsAdder — это самый мощный плагин для создания кастомного контента в Minecraft. Он позволяет добавлять НОВЫЕ предметы, блоки, мобов, интерфейсы, эмиссивы (светящиеся текстуры), 3D-модели, музыку и звуки — и всё это автоматически упаковывается в ресурспак, который игроки скачивают при заходе на сервер. В этом гайде я покажу, как создать свой первый кастомный предмет, настроить текстуру, рецепт крафта, способность и анимацию.

Установка

1. Купите ItemsAdder на SpigotMC (платный, ~20 евро) или скачайте бесплатную Lite-версию для тестирования.
2. Поместите JAR-файл в папку plugins.
3. Установите LoneLibs (библиотека, требуется для ItemsAdder).
4. Перезапустите сервер. ItemsAdder создаст папку plugins/ItemsAdder с ВСЕМИ необходимыми подпапками и примерами.

Структура папок (важно понимать)

plugins/ItemsAdder/
├── data/
│   ├── items_packs/
│   │   └── my_items/           # ВАШ пакет предметов
│   │       ├── items/          # Конфигурация предметов (.yml)
│   │       ├── models/         # 3D-модели (.json)
│   │       └── textures/       # Текстуры (.png)
│   ├── resource_pack/          # Готовый ресурспак (генерируется автоматически)
│   └── config.yml              # Главный конфиг

Создание первого кастомного предмета

Создайте файл plugins/ItemsAdder/data/items_packs/my_items/items/my_sword.yml:

items:
  my_sword:
    display_name: "&6Огненный Меч"
    permission: my_sword
    resource:
      material: DIAMOND_SWORD
      generate: true
      textures:
        - item/my_sword.png
    specific_properties:
      attack_damage: 10
      attack_speed: 2
    lore:
      - "&7Выкован в недрах ада"
      - "&7Наносит дополнительный урон"
    enchants:
      - FIRE_ASPECT:2
      - SHARPNESS:5

Поместите текстуру меча (my_sword.png) в папку textures/item/. Размер текстуры: 16x16, 32x32 или 64x64 пикселей.

Применение изменений:

/iareload

Игроки автоматически получат обновлённый ресурспак. Предмет можно выдать командой:

/iaget my_items:my_sword

Создание кастомного блока

Создайте файл my_blocks.yml в папке items/:

items:
  ruby_block:
    display_name: "&cРубиновый Блок"
    resource:
      material: PAPER
      generate: true
      textures:
        - block/ruby_block.png
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
          break_particles: ITEM
        cancel_drop: false
        hardness: 5
        blast_resistance: 100

Блок будет выглядеть как рубиновый, но вести себя как камень (твёрдость 5, устойчивость к взрывам 100).

Создание рецепта крафта

В том же файле добавьте секцию recipes:

recipes:
  crafting_table:
    my_sword:
      permission: my_sword
      pattern:
        - " D "
        - " D "
        - " S "
      ingredients:
        D: "minecraft:diamond"
        S: "minecraft:stick"
      result:
        item: "my_items:my_sword"
        amount: 1

Теперь меч можно скрафтить в верстаке: 2 алмаза + 1 палка = Огненный Меч.

Создание способности предмета (Actions)

ItemsAdder позволяет предметам выполнять действия при клике правой кнопкой, при ударе, при надевании.

behaviours:
  my_sword:
    right_click:
      type: FIREBALL
      cooldown: 10
      damage: 5
      speed: 2

Теперь при клике ПКМ меч запускает огненный шар с кулдауном 10 секунд.

Создание кастомного GUI (интерфейса)

ItemsAdder позволяет создавать кастомные меню с иконками, которые выполняют команды.

gui:
  main_menu:
    title: "&6Главное меню"
    rows: 3
    items:
      shop:
        slot: 11
        item: "my_items:shop_icon"
        display_name: "&aМагазин"
        lore:
          - "&7Открыть магазин сервера"
        left_click:
          - "servercommand: shop"
      warp_spawn:
        slot: 15
        item: "minecraft:ender_pearl"
        display_name: "&bТелепорт на спавн"
        left_click:
          - "playercommand: spawn"

Типичные ошибки

• Текстура не отображается (чёрно-фиолетовый предмет). Проверьте название файла текстуры — оно должно ТОЧНО совпадать с путём в конфиге. Проверьте формат PNG.
• Игроки не видят кастомные предметы. Они должны принять ресурспак при входе. Проверьте, что в server.properties параметр resource-pack= пуст (ItemsAdder сам управляет ресурспаком).
• Рецепт не работает в верстаке. Проверьте, что ингредиенты указаны с minecraft: префиксом для ванильных предметов.

💡 Совет профи

Начните с копирования примеров из папки ItemsAdder/data/items_packs/. Там лежат десятки готовых конфигов — мечи, броня, блоки, декорации, еда. Скопируйте пример, замените текстуру и название — и у вас готовый кастомный предмет за 5 минут. Не пишите конфиги с нуля, пока не освоите структуру.