ItemsAdder: установка, ресурспак и свои предметы

Установка

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.