ItemJoin

ItemJoin - это мощный плагин для серверов Minecraft (Spigot/Paper), который позволяет выдавать игрокам кастомные предметы при самых разных событиях: входе на сервер, возрождении, смене мира, входе/выходе из региона, первом входе и даже при первом посещении конкретного мира. Если вы администратор и хотите гибко управлять выдачей предметов на хабе, мини-играх, выживании или фракциях - этот плагин станет незаменимым инструментом.

Плагин решает проблему раздачи предметов вручную или с помощью костылей. Вы можете настроить неограниченное количество предметов для любого мира, ограничить выдачу по количеству, чтобы не плодить дубликаты, и даже привязать предметы к IP-адресу игрока для защиты от злоупотреблений.

Основные возможности

• Гибкие триггеры выдачи - предметы можно выдавать при входе, возрождении, смене мира, входе/выходе из региона (WorldGuard), первом входе, первом посещении мира и других событиях.
• Кастомизация предметов - каждому предмету можно задать уникальное название, описание (lore), зачарования (включая небезопасные уровни), текстуру головы игрока, эффекты, команды при клике и многое другое.
• ItemCommands - привяжите к предмету команды, которые выполняются при клике (левой/правой кнопкой, в инвентаре, физическом взаимодействии). Можно настроить разные команды для разных действий, добавить экономическую стоимость, кулдаун с частицами и звуками.
• Ограничения - предметы можно ограничить по игровому режиму, IP-адресу, количеству выдач, вероятности получения (рандомный шанс).
• Поддержка слотов - работа с любыми слотами инвентаря, включая броню и крафт.
• Динамическое обновление - предметы обновляются при изменении плейсхолдеров (например, PlaceholderAPI).
• Блокировка перемещения/подбора - можно запретить перемещение предметов или их подбор в определённых мирах.
• Совместимость - интеграция с Vault, PlaceholderAPI, Multiverse-Inventories, WorldGuard, AuthMe, TokenEnchant, HeadDatabase и другими плагинами.

Команды

Все команды доступны через /ItemJoin или сокращённо /IJ. Вот полный список:

   itemjoin:
      description: Показывает информацию о плагине, версию и автора, а также перенаправляет в меню помощи.
      permission: itemjoin.use
      aliases: [ij]
      usage: |
          /itemjoin
          Пример: /itemjoin
   itemjoin help:
      description: Отображает страницу доступных команд.
      permission: itemjoin.use
      usage: |
          /itemjoin help
          Пример: /itemjoin help
          Пример: /itemjoin help 2
          ... (до 9)
   itemjoin reload:
      description: Перезагружает все конфигурационные файлы плагина.
      permission: itemjoin.reload
      usage: |
          /itemjoin reload
          Пример: /itemjoin reload - Configuration(s) Reloaded!
   itemjoin menu:
      description: Открывает графическое меню для просмотра, изменения и создания кастомных предметов.
      permission: itemjoin.menu
      usage: |
          /itemjoin menu
          Пример: /itemjoin menu - The creator menu has been launched!
   itemjoin info:
      description: Показывает информацию о предмете в руке (тип материала, data value).
      permission: itemjoin.use
      usage: |
          /itemjoin info
          Пример: /itemjoin info - The item type is WOODEN_SWORD.
   itemjoin world:
      description: Показывает, в каком мире вы находитесь (полезно для отладки).
      permission: itemjoin.use
      usage: |
          /itemjoin world
          Пример: /itemjoin world - You are in the world Pandora_the_end.
   itemjoin list:
      description: Показывает список определённых предметов и их миры.
      permission: itemjoin.list
      usage: |
          /itemjoin list
          Пример: /itemjoin list - Current defines items are map-item, ultra-item.
   itemjoin updates:
      description: Проверяет наличие обновлений плагина.
      permission: itemjoin.updates
      usage: |
          /itemjoin updates
          Пример: /itemjoin updates - You have requested to check for available plugin updates!
   itemjoin upgrade:
      description: Принудительно обновляет плагин до последней версии (требуется перезагрузка сервера).
      permission: itemjoin.upgrade
      usage: |
          /itemjoin upgrade
          Пример: /itemjoin upgrade - You have requested to force update the plugin.
   itemjoin permissions:
      description: Показывает все разрешения (permissions) игрока, включая кастомные для предметов.
      permission: itemjoin.permissions
      usage: |
          /itemjoin permissions
          Пример: /itemjoin permissions - You have the permissions itemjoin.reload.
          Пример: /itemjoin permissions 2 - You have the permissions ultra-item.
   itemjoin get:
      description: Выдаёт указанный кастомный предмет игроку.
      permission: itemjoin.get, itemjoin.get.others
      usage: |
          /itemjoin get
          Пример: /itemjoin get Ultra - You have received the item [Ultra]!
          Пример: /itemjoin get Ultra 12 - You have received 12x of the item [Ultra]!
          Пример: /itemjoin get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!
          Пример: /itemjoin get Ultra RockinChaos 8 - You have given 8x of the item [Ultra] to RockinChaos!
   itemjoin getOnline:
      description: Выдаёт предмет всем онлайн-игрокам.
      permission: itemjoin.get.others
      usage: |
          /itemjoin getOnline
          Пример: /itemjoin getOnline Ultra - You have given the item [Ultra] to RockinChaos!
          Пример: /itemjoin getOnline Ultra 8 - You have given 8x of the item [Ultra] to RockinChaos!
   itemjoin getall:
      description: Выдаёт все кастомные предметы указанному игроку.
      permission: itemjoin.get, itemjoin.get.others
      usage: |
          /itemjoin getall
          Пример: /itemjoin getall - You have received all of the ItemJoin items.
          Пример: /itemjoin getall RockinChaos - You have given RockinChaos all of the ItemJoin items that are available.
   itemjoin remove:
      description: Удаляет указанный кастомный предмет из инвентаря игрока.
      permission: itemjoin.remove, itemjoin.remove.others
      usage: |
          /itemjoin remove
          Пример: /itemjoin remove Ultra - You have removed the item [Ultra]!
          Пример: /itemjoin remove Ultra 12 - You have removed 12x of the item [Ultra]!
          Пример: /itemjoin remove Ultra RockinChaos - You have removed the item [Ultra] to RockinChaos!
          Пример: /itemjoin remove Ultra RockinChaos 8 - You have removed 8x of the item [Ultra] to RockinChaos!
   itemjoin removeOnline:
      description: Удаляет предмет у всех онлайн-игроков.
      permission: itemjoin.remove.others
      usage: |
          /itemjoin removeOnline
          Пример: /itemjoin removeOnline Ultra - You have removed the item [Ultra] from RockinChaos!
          Пример: /itemjoin removeOnline Ultra 8 - You have removed 8x of the item [Ultra] from RockinChaos!
   itemjoin removeall:
      description: Удаляет все кастомные предметы у указанного игрока.
      permission: itemjoin.remove, itemjoin.remove.others
      usage: |
          /itemjoin removeall
          Пример: /itemjoin removeall - You have removed all of the ItemJoin items from your inventory.
          Пример: /itemjoin removeall RockinChaos - You have removed all of the ItemJoin items from RockinChaos.
   itemjoin enable:
      description: Включает использование кастомных предметов для всех игроков или указанного.
      permission: itemjoin.enable, itemjoin.enable.others
      usage: |
          /itemjoin enable
          Пример: /itemjoin enable - You have globally enabled custom items.
          Пример: /itemjoin enable RockinChaos - You have enabled custom items for RockinChaos!
          Пример: /itemjoin enable RockinChaos world_the_end - You have enabled custom items for RockinChaos in the world world_the_end!
   itemjoin disable:
      description: Отключает использование кастомных предметов.
      permission: itemjoin.disable, itemjoin.disable.others
      usage: |
          /itemjoin disable
          Пример: /itemjoin disable - You have globally disabled custom items.
          Пример: /itemjoin disable RockinChaos - You have disabled custom items for RockinChaos!
          Пример: /itemjoin disable RockinChaos world_the_end - You have disabled custom items for RockinChaos in the world world_the_end!
   itemjoin purge:
      description: Очищает данные из базы данных (все или указанные) для всех игроков или конкретного.
      permission: itemjoin.purge
      usage: |
          /itemjoin purge
          Пример: /itemjoin purge - You have purged ALL data from the database file!
          Пример: /itemjoin purge first-join - You have purged ALL first-join data from the database file!
          Пример: /itemjoin purge first-world - You have purged ALL first-world data from the database file!
          Пример: /itemjoin purge ip-limits - You have purged ALL IP-limit data from the database file!
          Пример: /itemjoin purge first-join RockinChaos - You have purged ALL first-join data of RockinChaos from the database file!
          Пример: /itemjoin purge first-world RockinChaos - You have purged ALL first-world data of RockinChaos from the database file!
          Пример: /itemjoin purge ip-limits RockinChaos - You have purged ALL ip-limit data of RockinChaos from the database file!

Разрешения (Permissions)

Права доступа чувствительны к регистру, включая названия миров. Основные узлы:

   itemjoin.*:
      description: Даёт доступ ко всем аспектам плагина.
      default: false
      children:
          itemjoin.all: true
   itemjoin.all:
      description: Даёт доступ ко всем командам и функциям.
      default: false
      children:
          itemjoin.use: true
          itemjoin.reload: true
          itemjoin.menu: true
          itemjoin.updates: true
          itemjoin.upgrade: true
          itemjoin.permissions: true
          itemjoin.list: true
          itemjoin.purge: true
          itemjoin.get: true
          itemjoin.get.others: true
          itemjoin.remove: true
          itemjoin.remove.others: true
          itemjoin.enable: true
          itemjoin.enable.others: true
          itemjoin.disable: true
          itemjoin.disable.others: true
          itemjoin.bypass.inventorymodify: false
   itemjoin.use:
      description: Доступ к базовым командам (info, world, help).
      default: true
   itemjoin.menu:
      description: Доступ к команде /itemjoin menu.
      default: false
   itemjoin.reload:
      description: Доступ к перезагрузке конфигов.
      default: false
   itemjoin.updates:
      description: Проверка обновлений.
      default: false
   itemjoin.upgrade:
      description: Принудительное обновление.
      default: false
   itemjoin.permissions:
      description: Просмотр своих разрешений.
      default: true
   itemjoin.list:
      description: Список предметов.
      default: false
   itemjoin.purge:
      description: Очистка базы данных.
      default: false
   itemjoin.get:
      description: Выдача предметов себе.
      default: false
   itemjoin.get.others:
      description: Выдача предметов другим.
      default: false
   itemjoin.remove:
      description: Удаление предметов у себя.
      default: false
   itemjoin.remove.others:
      description: Удаление предметов у других.
      default: false
   itemjoin.enable:
      description: Включение выдачи.
      default: false
   itemjoin.enable.others:
      description: Включение для других.
      default: false
   itemjoin.disable:
      description: Отключение выдачи.
      default: false
   itemjoin.disable.others:
      description: Отключение для других.
      default: false
   itemjoin.bypass.inventorymodify:
      description: Игнорирование ограничений на перемещение предметов.
      default: false

Разрешения для предметов

Чтобы игрок мог получить конкретный предмет в определённом мире, используются разрешения вида itemjoin.<мир>.<предмет>. Например:

• itemjoin.world_the_end.ultra-item - доступ к предмету ultra-item в мире world_the_end.
• itemjoin.world_the_end.* - доступ ко всем предметам в этом мире.

По умолчанию проверка разрешений отключена. Чтобы включить, в config.yml установите Permissions.Obtain-Item: true. Также можно задать кастомное разрешение для каждого предмета через параметр permission-node в items.yml:

items:
  example-item:
    id: DIAMOND_SWORD
    slot: 0
    permission-node: 'itemjoin.specialty'

Важно знать

Есть ли у ItemJoin свой API? Да, плагин предоставляет API для интеграции с другими плагинами. Все методы находятся в me.RockinChaos.itemjoin.api.ItemJoinAPI. Если нужного метода нет, можно оставить запрос на GitHub.

Поддерживает ли ItemJoin плейсхолдеры? Да, встроено несколько плейсхолдеров, а при включении PlaceholderAPI (в config.yml PlaceholderAPI: true) становятся доступны все плейсхолдеры этого плагина.

Работает ли с несколькими мирами? Да, предметы выдаются только в тех мирах, которые указаны в items.yml. Плагин также может интегрироваться с Multiverse-Inventories, xInventories, PerWorldInventory для разделения инвентарей по мирам без очистки.

Можно ли выдать предметы только при первом входе? Да, добавьте флаг first-join к предмету. Можно комбинировать с IP-лимитом.

Можно ли ограничить предметы по IP? Да, используйте флаг IP-limit. Предмет будет привязан к IP-адресу игрока, что снижает риск злоупотреблений.

Зависимости? ItemJoin не требует обязательных плагинов, но поддерживает опциональные:

• Vault - экономика для команд.
• PlaceholderAPI - плейсхолдеры.
• Multiverse-Core / MyWorlds - мульти-мир.
• Multiverse-Inventories / xInventories / PerWorldInventory - разделение инвентарей.
• WorldGuard - выдача предметов при входе в регион.
• AuthMe - выдача после авторизации.
• TokenEnchant - зачарования.
• HeadDatabase - кастомные головы.
• BetterNick - совместимость с никнеймами.