Pterohost docs

ItemsAdder: кастомные предметы и блоки в Minecraft

Полный гайд по ItemsAdder: установка, генерация ресурспака, кастомные предметы, блоки, мобы и эмодзи. Настройка с нуля для Minecraft 1.20-1.21.

Кратко: ItemsAdder - плагин для добавления кастомных предметов, блоков и мобов в Minecraft без модов. Он работает через ресурспак и PacketAPI, не требует ничего от клиента кроме принятия ресурспака. Гайд покрывает полную установку, настройку и базовые кейсы для Minecraft 1.20-1.21 на ядре Paper/Purpur.

ItemsAdder: кастомные предметы и блоки в Minecraft

ItemsAdder - это самый мощный плагин для кастомизации ванильного Minecraft без модов. С его помощью можно добавить сотни уникальных предметов, блоков, оружия, брони, еды, мобов и даже эмодзи в чат - всё это работает только через ресурспак и серверный плагин, клиенту не нужно ничего устанавливать. В 2026 году ItemsAdder занимает лидирующее место среди решений для RPG, выживания и тематических серверов. Плагин поддерживает Minecraft 1.20.x-1.21.x, активно обновляется и имеет огромную экосистему аддонов.

Pterohost - игровой хостинг с NVMe-дисками, DDoS-защитой и поддержкой 24/7: идеально для серверов с тяжёлыми ресурспаками. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Зависимости и требования

Перед установкой ItemsAdder убедитесь, что у вас выполнены все зависимости. Пропуск любой из них приведёт к ошибкам при загрузке плагина.

Обязательные зависимости:

ЗависимостьНазначениеГде скачать
ProtocolLib 5.xПерехват и модификация пакетовgithub.com/dmulloy2/ProtocolLib
LoneLibs 1.xВспомогательная библиотека автораspigotmc.org (автор LoneDev)
ItemsAdderСам плагинspigotmc.org / builtbybit.com

Рекомендуемые:

  • PlaceholderAPI - для плейсхолдеров в именах предметов и описаниях
  • WorldGuard - для привязки спавна кастомных мобов к регионам
  • MythicMobs - для создания мобов с полноценным AI
  • Vault - для экономики с кастомными предметами в качестве валюты

Требования к серверу:

  • Java 17+ (обязательно для Minecraft 1.20+)
  • Paper 1.20.1 или новее (Purpur тоже поддерживается; Spigot работает, но с ограничениями)
  • ОЗУ: от 4 GB при большом количестве текстур; для среднего сервера с ItemsAdder хватает 6-8 GB
  • Свободное место: зависит от количества текстур, от 500 MB до нескольких GB

Установка ItemsAdder

Шаг 1 - Размещение jar-файлов

Положите все jar-файлы в папку plugins/ и запустите сервер:

plugins/
  ProtocolLib.jar
  LoneLibs.jar
  ItemsAdder.jar

После первого запуска ItemsAdder создаст структуру папок:

plugins/
  ItemsAdder/
    config.yml          <- основной конфиг
    storage/
      resourcepacks/    <- генерируемые ресурспаки
      data/             <- данные сохранений
    contents/
      itemsadder/       <- встроенные предметы и примеры
      my_items/         <- ваши кастомные пакеты (создайте сами)

Шаг 2 - Базовая настройка config.yml

Откройте plugins/ItemsAdder/config.yml и проверьте ключевые параметры:

# Способ доставки ресурспака игрокам
resource-pack:
  hosting:
    # Встроенный HTTP-сервер (самый простой способ)
    # ItemsAdder сам раздаёт ZIP-файл через HTTP
    self-host:
      enabled: true
      port: 8163             # порт должен быть открыт в файрволе
      # Если сервер за NAT - укажите внешний IP вручную
      # server-ip: "1.2.3.4"
    
    # Альтернатива - загрузка на внешний хостинг (Dropbox, custom)
    external:
      enabled: false
      url: ""
      sha1: ""

# Генерация ресурспака
zip-generation:
  # Автоматически перегенерировать при запуске
  auto-regenerate-on-startup: true
  # Кешировать изображения для ускорения генерации
  image-cache: true

# Язык
lang: ru

После изменения config.yml сохраните файл и выполните /iazip в игре или перезапустите сервер.

Шаг 3 - Открытие порта для ресурспака

Если используете self-host, откройте порт 8163 (или тот, что указали) в файрволе:

# UFW
ufw allow 8163/tcp

# Iptables
iptables -A INPUT -p tcp --dport 8163 -j ACCEPT

На управляемых хостингах (Pterohost, etc.) откройте порт через панель управления в разделе Network.

Структура кастомного контента

ItemsAdder организует контент в пакеты (namespaces). Каждый пакет - отдельная папка внутри contents/. Это удобно: разные пакеты не конфликтуют между собой.

Создайте свой пакет, например my_server:

contents/
  my_server/
    config/
      items.yml         <- описание предметов
      blocks.yml        <- описание блоков
      mobs.yml          <- описание мобов
    resourcepack/
      assets/
        my_server/
          textures/
            item/       <- текстуры предметов (PNG 16x16 или 32x32)
            block/      <- текстуры блоков
          models/
            item/       <- JSON-модели предметов

Namespace my_server будет использоваться как префикс в командах: my_server:item_name.

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

Рассмотрим создание кастомного предмета - рубинового меча.

1. Добавьте текстуру

Положите PNG-файл текстуры (16x16 или кратно) в:

contents/my_server/resourcepack/assets/my_server/textures/item/ruby_sword.png

2. Создайте конфиг предмета

Файл contents/my_server/config/items.yml:

info:
  namespace: my_server

items:
  ruby_sword:
    display_name: "Рубиновый меч"
    permission: ""                      # пусто = доступен всем
    lore:
      - "&7Скован из&c рубинов&7 гор"
      - ""
      - "&cУрон&7: +8"
    resource:
      material: DIAMOND_SWORD           # базовый предмет (vanilla)
      generate: true                    # автогенерация модели из текстуры
      textures:
        - item/ruby_sword               # путь без расширения
    durability:
      max-custom-durability: 1500
    attribute_modifiers:
      generic_attack_damage:
        operation: add_number
        amount: 8
        slot: HAND
    events:
      interact:
        right:
          action: PLAY_SOUND
          sound: minecraft:entity.experience_orb.pickup
          volume: 1
          pitch: 1.2

3. Перегенерируйте ресурспак

/iazip

После этого команда /iagive <игрок> my_server:ruby_sword 1 выдаст предмет.

Кастомные блоки

Блоки в ItemsAdder работают через мушрумы (mushroom blocks) - технические блоки, которые имеют 6 независимых граней. Это позволяет создавать до 1400+ уникальных блоков без конфликтов с ванилью.

Файл contents/my_server/config/blocks.yml:

info:
  namespace: my_server

blocks:
  ruby_ore:
    display_name: "Рубиновая руда"
    resource:
      material: MUSHROOM_STEM            # используем mushroom-блок
      generate: true
      textures:
        north: block/ruby_ore
        south: block/ruby_ore
        east:  block/ruby_ore
        west:  block/ruby_ore
        up:    block/ruby_ore
        down:  block/ruby_ore
    specific_properties:
      block:
        hardness: 4.0
        blast_resistance: 4.0
    drop:
      fortune_compatible: true
      silktouch: true
      loots:
        - loot:
            name: my_server:ruby_gem
            chance: 100
            min_amount: 1
            max_amount: 3

Разместить блок в мире можно командой /iasetblock my_server:ruby_ore или через механику крафта.

Кастомные блоки-мебель и декор

Для мебели используется тип блока REAL_NOTE:

blocks:
  wooden_chair:
    display_name: "Деревянный стул"
    resource:
      material: REAL_NOTE               # тип для кастомных форм (через note_block)
      generate: false                   # используем свою модель
      model_path: my_server/chair       # путь к JSON-модели

REAL_NOTE использует note block state и даёт больше вариантов форм, но требует ручной JSON-модели.

Кастомные мобы

Простые мобы через подмену модели

ItemsAdder позволяет создавать мобов через переодевание существующих сущностей:

info:
  namespace: my_server

mobs:
  ruby_golem:
    display_name: "Рубиновый голем"
    resource:
      material: ZOMBIE                  # базовая сущность
      generate: true
      model_folder: mob/ruby_golem      # папка с моделью и текстурами
    hit_color: RED
    max_health: 80
    can_sun_burn: false
    behavior:
      - MONSTER
    loots:
      - loot:
          name: my_server:ruby_gem
          chance: 75

Продвинутые мобы через MythicMobs

Для мобов с полноценным ИИ, скиллами и боссбаром используйте MythicMobs совместно с ItemsAdder. ItemsAdder отвечает за внешний вид (модель, текстуры), MythicMobs - за поведение:

# plugins/MythicMobs/Mobs/ruby_boss.yml
RubyBoss:
  Type: ZOMBIE
  Health: 500
  Damage: 12
  Options:
    MovementSpeed: 0.3
    ItemsAdderMob: my_server:ruby_golem   # указываем модель из ItemsAdder
  Skills:
  - skill{s=RubySlam} @target ~onTimer:100

Эмодзи в чате

Одна из уникальных фишек ItemsAdder - Unicode-символы для чата. Добавьте смайлики или иконки через конфиг эмодзи:

info:
  namespace: my_server

font_images:
  emoji_heart:
    symbol: ""                    # unicode-код символа
    texture: emoji/heart                # PNG в textures/font/
    height: 8
    ascent: 8
    chat:
      enabled: true
      show: ":heart:"                   # текст, который заменится на иконку
  
  emoji_diamond:
    symbol: ""
    texture: emoji/diamond
    height: 8
    ascent: 8
    chat:
      enabled: true
      show: ":diamond:"

После /iazip игроки смогут писать в чате :heart: и видеть иконку сердца. Эмодзи работают в чате, табе, скорборде и в названиях предметов через PlaceholderAPI.

Встроенный набор эмодзи ItemsAdder содержит более 200 символов. Используйте аддоны (itemsadder:emoji_pack) для расширения набора.

Выдача предметов и интеграция с экономикой

Команды выдачи

# Выдать предмет игроку
/iagive Alex my_server:ruby_sword 1

# Выдать предмет с мета-данными
/iagive Alex my_server:ruby_sword 1 {custom_data:1}

# Проверить, держит ли игрок кастомный предмет (в командах/скриптах)
/iacheck Alex my_server:ruby_sword

Крафт кастомных предметов

items:
  ruby_sword:
    # ...
    recipes:
      crafting:
        - recipe:
            permission: ""
            pattern:
              - " R "
              - " R "
              - " S "
            keys:
              R:
                material: my_server:ruby_gem    # кастомный предмет как ингредиент
              S:
                material: STICK

Интеграция с Vault/ShopGUI+

ItemsAdder-предметы можно использовать как валюту или товары в магазинах через PlaceholderAPI и ItemsAdder API. Базовая интеграция для ShopGUI+:

# В конфиге ShopGUI+
shop1:
  type: ITEM
  item:
    material: DIAMOND_SWORD
    itemsadder: "my_server:ruby_sword"   # указываем ItemsAdder-предмет
  buyPrice: 500
  sellPrice: 250

Совместимость плагинов

ПлагинСовместимостьПримечание
Paper 1.20-1.21ПолнаяРекомендуется
PurpurПолнаяДополнительные опции
SpigotЧастичнаяНекоторые фичи недоступны
EssentialsXПолнаяКоманды /give работают с IA-предметами через кастомный обработчик
WorldGuardПолнаяОграничение размещения кастомных блоков в регионах
MythicMobsПолнаяРекомендуется для мобов
LuckPermsПолнаяРазграничение прав на предметы
PlaceholderAPIПолнаяПлейсхолдеры в именах, описаниях
OraxenНесовместимКонкурирующий плагин, использует тот же механизм
ItemEditЧастичнаяОграниченная поддержка кастомных предметов

Важно: ItemsAdder и Oraxen используют одинаковый механизм (Custom Model Data + mushroom blocks), поэтому на одном сервере они конфликтуют. Выбирайте один из двух.

Оптимизация нагрузки на сервер

ItemsAdder при неправильной настройке может существенно замедлить запуск сервера и увеличить потребление памяти.

Ключевые настройки производительности

# config.yml - раздел performance
performance:
  # Не генерировать ресурспак при каждом запуске
  # Используйте /iazip только после изменений
  auto-regenerate-on-startup: false
  
  # Кеш изображений ускоряет повторные генерации
  image-cache: true
  
  # Асинхронная генерация ресурспака (не блокирует основной поток)
  async-generation: true

# Ограничение радиуса загрузки кастомных блоков
chunk-engine:
  enabled: true
  # Кешировать состояния блоков в чанках
  cache: true

Рекомендации по текстурам

  • Используйте текстуры 16x16 или 32x32 - не выше (экономит VRAM клиента и размер ZIP)
  • Оптимизируйте PNG через pngquant или oxipng перед добавлением
  • Разбивайте большой пакет на несколько namespace - так проще контролировать нагрузку
  • Удаляйте неиспользуемые текстуры - они всё равно попадают в ресурспак

Мониторинг потребления

# В игре - проверить состояние ItemsAdder
/iadebug

# Посмотреть загруженные предметы
/iali all

# Перегенерировать ресурспак без рестарта
/iazip

Типичные показатели: сервер с 300-500 кастомными предметами и 100-200 блоками потребляет дополнительно 1-2 GB RAM при генерации ресурспака и около 200-400 MB в рантайме.

Права доступа (LuckPerms)

# Базовые права администратора
/lp user Alex permission set itemsadder.command.give true
/lp user Alex permission set itemsadder.command.zip true
/lp user Alex permission set itemsadder.command.debug true

# Права на использование эмодзи
/lp group default permission set itemsadder.emoji.use true

# Запрет на конкретный предмет
/lp group guest permission set itemsadder.item.my_server.ruby_sword false

Обновление ItemsAdder

При обновлении версии плагина:

  1. Остановите сервер
  2. Замените ItemsAdder.jar на новую версию
  3. Не удаляйте папку plugins/ItemsAdder/contents/ - там ваши данные
  4. Запустите сервер, проверьте консоль на ошибки миграции
  5. Выполните /iazip для перегенерации ресурспака под новый формат
  6. Проверьте CHANGELOG плагина - иногда меняется синтаксис YAML-конфигов

Связанные материалы

Для полноценного RPG-сервера с кастомными предметами важно выбрать подходящее ядро - читайте обзор серверных ядер Minecraft. Если после добавления ItemsAdder сервер начал лагать, поможет руководство по оптимизации. А для настройки экономики вокруг кастомных предметов изучите гайд по Vault и экономике.

Заключение

ItemsAdder - профессиональный инструмент, который превращает ванильный Minecraft-сервер в полноценную игровую платформу с уникальными предметами, блоками и мобами без модов на стороне клиента. Ключ к успешной работе - правильная установка зависимостей, грамотная структура namespace и оптимизация текстур. Плагин активно развивается и в 2026 году поддерживает все актуальные версии Minecraft вплоть до 1.21.x. Начните с малого набора предметов, изучите структуру конфигов и постепенно расширяйте контент - такой подход даст стабильный сервер без деградации производительности.

Pterohost - Minecraft-хостинг с NVMe-дисками, автоматическим бэкапом и круглосуточной поддержкой: оптимальная среда для серверов с тяжёлыми ресурспаками ItemsAdder. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг