ItemsAdder для Minecraft 1.20.6–26.2: установка, ресурспак и свои предметы

ItemsAdder добавляет на сервер предметы, блоки, мебель, эмодзи и HUD со своими текстурами, которые игроки получают через ресурспак. Плагин платный, зато собирает пак сам и умеет раздавать его без отдельного веб-сервера. Ниже установка, хостинг пака и первый свой предмет по официальной вики.

ItemsAdder и версии Minecraft

ItemsAdder работает на серверах 1.20.6–26.2. Подробнее о поддержке: ItemsAdder 4 для 1.20.6 и новее (проверен до 26.2), ItemsAdder 3 для 1.20.4 и старше.

Подходит для серверов на версиях:

1.20.61.211.21.11.21.41.21.81.21.101.21.1126.126.2

Установка

  1. Купите плагин на SpigotMC, Polymart или BuiltByBit и скачайте jar. Для 1.20.6 и новее нужна ветка 4.x, для 1.20.4 и старше 3.x.
  2. Остановите сервер, положите в plugins ItemsAdder и ProtocolLib.
  3. Запустите сервер: появится plugins/ItemsAdder с config.yml и папкой contents.
  4. Настройте хостинг ресурспака (следующий раздел).
  5. Выполните /iazip: команда перечитывает конфиги и собирает пак.

Как раздать ресурспак игрокам

Текстуры попадают к игроку только через ресурспак, поэтому без хостинга пака ItemsAdder показывает обычные ванильные предметы. Самый простой вариант с версии 4.0.17: встроенный simple_self_host. По словам вики, он не требует настройки и проброса портов. Выключите остальные методы хостинга в config.yml и включите этот:

hosting:
  simple_self_host:
    enabled: true
    server_address: auto
    optimization:
      block_non_game_requests: true
      max_downloads_per_ip: 5
      max_speed_in_megabyte_ps: 30

После этого /iazip, и пак уходит игрокам при входе. В server_address можно вписать адрес и порт сервера вручную, если auto не сработал.

Другие варианты из вики: LobFile (внешний файлообменник), self hosting на своём веб-сервере и no-host, когда пак раздаёте сами. Отказ от пака может закончиться киком, право ia.resourcepack.bypasskick от него освобождает. Если игроку нужно перекачать пак, есть /iatexture.

Как добавить свой предмет

Весь контент лежит в plugins/ItemsAdder/contents/<namespace>/. Пример из официального туториала: свой меч.

Конфиг contents/my_items/configs/myswords.yml:

info:
  namespace: my_items
items:
  mysword:
    name: My Sword
    material: DIAMOND_SWORD
    permission_suffix: my_items.mysword
    graphics:
      texture: item/mysword
    durability:
      max_durability: 1324

Текстура кладётся в contents/my_items/textures/item/mysword.png. Путь в texture считается от contents/my_items/textures/ и пишется без .png.

Блок graphics это новый формат (ItemsAdder 4.0.13+, клиенты 1.21.4+). Для клиентов 1.21.3 и старше вики даёт старую форму: resource с material, generate: true и texture: item/mysword.png. В версиях 4.0.8 и ниже вместо name было display_name.

  1. /iazip, чтобы пересобрать пак.
  2. /iaget my_items:mysword, чтобы получить меч.

material задаёт ванильную основу: от него зависят урон и поведение, а внешний вид берётся из текстуры.

Права для игроков

Игроку для меню предметов нужен ia.user.ia, для отдельной категории ia.user.ia.categories. Рецепты открывает ia.user.iarecipe, список эмодзи ia.user.image.gui. Всё с приставкой ia.admin оставьте администрации: /iaget, /iadrop и /iarename создают предметы из воздуха.

Видимость конкретных предметов в меню /ia регулируется правами вида ia.user.ia.seeitem.<право>, а ia.user.ia.seeitem.* показывает все предметы.

Частые проблемы

  • Предмет виден как обычный алмазный меч. Пак не собран или не дошёл до игрока: выполните /iazip, проверьте, что включён ровно один метод хостинга, и попросите игрока ввести /iatexture.
  • Пропали ID после удаления предметов. /iacleancache освобождает неиспользуемые ID для новых блоков и предметов.
  • Не ясно, что за предмет в руке. /iatag покажет отладочную информацию, /iablock то же для блока перед вами.
  • Скачали jar не той ветки. 3.x и 4.x разнесены по версиям игры, на 1.21 ставится только 4.x.

Команды и права ItemsAdder

КомандаЧто делаетПраво
/iaменю со списком всех предметовia.user.ia
/ia <категория>открыть категорию предметовia.user.ia.categories
/iazipперезагрузить конфиги и собрать ресурспакia.admin.iazip
/iareloadперезагрузить конфиги без сборки пакаia.admin.iareload
/iaget <предмет> [кол-во]получить предмет по namespace:id или idia.admin.iaget
/iadrop <предмет> [кол-во]выбросить предмет на координатах или у игрокаia.admin.iadrop
/iaremove <предмет> [кол-во] [silent]забрать предмет из инвентаря игрокаia.admin.iaremove
/iatextureзаново загрузить ресурспак себеia.user.iatexture
/iatexture [all|игрок]перезагрузить пак игроку или всемia.user.iatexture.all
/iasha1посчитать sha1 текущего пакаia.user.iasha1
/iarecipe [предмет]меню рецепта предметаia.user.iarecipe
/iaimageсписок эмодзи и картинок шрифтаia.user.image.gui
/iatagотладочная информация о предмете в рукеia.admin.iatag
/iablockинформация о блоке, на который смотритеia.admin.iablock
/iacleancacheочистить неиспользуемые ID из кешаia.admin.iacleancache
/iarepairпочинить предмет в рукеia.admin.iarepair
/iarename <имя>переименовать предмет в руке, эмодзи поддерживаютсяia.admin.iarename
/iainfoинформация о плагинеia.admin.iainfo

Частые вопросы про ItemsAdder

Можно ли скачать ItemsAdder бесплатно?
Нет, это платный плагин за €19.99. Официально его продают только на SpigotMC, Polymart и BuiltByBit. Сборки с «бесплатных» сайтов не получают обновлений и могут содержать чужой код.
Работает ли ItemsAdder на 1.21?
Да, ветка 4.x рассчитана на 1.20.6 и новее и проверена до 26.2. Для 1.20.4 и старше нужна ветка 3.x.
Почему игроки не видят текстуры ItemsAdder?
Почти всегда виноват ресурспак: он не собран или не раздаётся. Выполните /iazip, включите один метод хостинга, например simple_self_host, и перезайдите. Отдельному игроку поможет /iatexture.
Как добавить свой предмет в ItemsAdder?
Создайте yml в папке contents/ваш_namespace/configs с блоками info и items, положите png в contents/ваш_namespace/textures, выполните /iazip и получите предмет через /iaget namespace:id.
Нужен ли ProtocolLib для ItemsAdder?
Да, ProtocolLib обязателен. LoneLibs начиная с 4.0.9 больше не нужен.
Нужен ли отдельный хостинг для ресурспака ItemsAdder?
С версии 4.0.17 нет: встроенный simple_self_host раздаёт пак сам, без проброса портов. Внешний хостинг или LobFile нужны, если хотите раздавать пак со стороннего адреса.
На каких версиях Minecraft работает ItemsAdder?
ItemsAdder подходит для серверов 1.20.6–26.2. Подробнее: ItemsAdder 4 для 1.20.6 и новее (проверен до 26.2), ItemsAdder 3 для 1.20.4 и старше. Какой файл брать под свою версию, разобрано на этой странице.

Не хочется настраивать самому

ItemsAdder уже стоит и настроен в готовых сборках Cloud Delight: права, меню, защита и донат собраны в одно целое. Скачали, запустили, играете.