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

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

Обновлено 13 августа 2026 г.

ItemsAdder добавляет свои предметы, блоки и мебель без модов — за счёт подмены моделей в ресурспаке. Общая картина — Кастомные предметы.

Порядок

Установить плагин и зависимости (обычно ProtocolLib и LoneLibs).
Положить свои модели и текстуры в plugins/ItemsAdder/data/items_packs/.
Сгенерировать пак:

/iazip

Раздать пак игрокам: сервер отдаёт его сам — Обязательный ресурспак. Плагин умеет поднимать раздачу сам или класть ссылку в конфиг.
Проверить с чистого клиента: без пака предметы выглядят как заглушки.

Пример предмета

items:
  ruby:
    display_name: '&cРубин'
    resource:
      material: DIAMOND
      generate: true
      textures:
        - ruby.png

Ошибки

Симптом	Причина
Предметы как палки	У игрока нет пака
Пак не обновился	Не сменён хеш ресурспака
Блоки пропадают при поломке	Не настроен `block` тип, используется `real_block`
Кракозябры в названиях	Файл не в UTF-8 — Локализация

Совместимость

Плагины, копирующие предметы (кейсы, киты, аукцион), должны понимать метки ItemsAdder — иначе покупатель получит обычный алмаз вместо рубина. Проверяйте весь путь предмета до открытия продаж.