Плагин - hClansPvPAddon [1.16.X-26.X] | Дополнение для плагина hClans

Поддерживаемые версии

1.16
1.17
1.18
1.19
1.20
1.21

Ядра и Прокси

Bukkit
Spigot
Paper

Минимальная версия Java: 17

hClansPvPAddon
Аддон управления PvP внутри клана для hClans

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

hClansPvPAddon — это аддон для hClans, который добавляет управление PvP между участниками одного клана.

Аддон позволяет включать или выключать урон между соклановцами, открывать GUI для управления PvP, настраивать персональные PvP-состояния между отдельными участниками и автоматически блокировать friendly-fire, если PvP внутри клана выключен.

Также поддерживаются снаряды и косвенные источники урона, ограничения по мирам, настраиваемые сообщения, клановые права и постоянное сохранение состояний через базу данных hClans.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

Общий переключатель PvP внутри клана.
Персональные PvP-настройки между отдельными участниками.
Настраиваемая подкоманда /clan pvp.
GUI для управления клановым PvP.
Список участников клана в меню.
Навигация по страницам участников.
Настраиваемый layout, title, размер и предметы GUI.
Кастомные материалы, названия, lore, actions и головы.
Настраиваемые алиасы enable и disable.
Опциональная проверка кланового права для переключения PvP.
Опция постоянного доступа для владельца клана.
Блокировка урона между соклановцами.
Поддержка урона от снарядов.
Определение косвенных источников урона: питомцы, TNT и другие поддерживаемые источники.
Blacklist и whitelist по мирам.
Настраиваемые уведомления для атакующего и жертвы.
Cooldown уведомлений против спама.
Постоянное хранение PvP-состояний через database API из hClans.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Как работает

Игрок открывает PvP-меню командой:

Код:

/clan pvp

Если игрок состоит в клане, аддон открывает настраиваемое GUI. В меню отображается текущее состояние PvP внутри клана, а игроки с доступом могут переключить его.

Аддон хранит два типа PvP-состояний:

Состояние клана — общий PvP-статус для всего клана.
Состояние пары — персональный PvP-статус между двумя конкретными участниками.

Когда один участник клана пытается ударить другого, hClansPvPAddon проверяет состояние клана, состояние пары и отменяет урон, если PvP выключен.

────────────────────────────────────────

Переключатель PvP клана

Общий переключатель управляет стандартным поведением friendly-fire между участниками клана.

Настройка по умолчанию:

Код:

settings:
  defaultPvpEnable: false

Если клан ещё не менял PvP-настройку, используется это значение.

────────────────────────────────────────

Персональные правила участников

GUI может отображать участников клана в виде player head предметов.

Игрок может нажать на предмет участника, чтобы переключить персональное PvP-состояние между собой и этим участником.

Это даёт более точную настройку, чем только общий режим PvP для всего клана.

Доступные плейсхолдеры участника:

Код:

{target}
{targetUuid}
{role}
{pairState}

────────────────────────────────────────

Обработка урона

Аддон обрабатывает события урона и проверяет, находятся ли атакующий и жертва в одном клане.

Поддерживается обработка:

прямого урона от игрока
урона от снарядов
урона от прирученных существ
источника TNT
источника area effect cloud
владельца Evoker Fangs

Если PvP для клана или пары выключен, урон отменяется.

────────────────────────────────────────

Ограничения по мирам

Контроль PvP можно ограничить по мирам.

Поддерживаемые режимы:

blacklist — отключить логику аддона в указанных мирах.
whitelist — работать только в указанных мирах.

Пример:

Код:

settings:
  damage:
    worlds:
      mode: blacklist
      list: []

────────────────────────────────────────

Уведомления

Аддон может уведомлять атакующего и опционально жертву, когда friendly-fire заблокирован.

Настройки уведомлений:

Код:

settings:
  damage:
    notify:
      attacker: true
      victim: false
      cooldownMillis: 5000

Cooldown защищает игроков от спама сообщениями во время боя.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Настройка GUI

GUI настраивается в файле:

Код:

plugins/hClansPvPAddon/gui.yml

Можно настроить:

title
размер
текст состояния
декоративные предметы
кнопку включения
кнопку выключения
предметы участников
пустые предметы участников
кнопки прошлой и следующей страницы
кнопку назад
материалы
слоты и page slots
priority
CustomModelData
display name
lore
actions

Стандартный title меню:

Код:

&0ToolRise &8| &0Клановое PvP

────────────────────────────────────────

GUI-плейсхолдеры

Плейсхолдеры для текста GUI и actions:

Код:

{clan}
{state}
{player}
{playerUuid}
{target}
{targetUuid}
{role}
{pairState}
{page}
{pages}

Их можно использовать в названиях предметов, lore и actions.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Конфигурация

Основной конфиг:

Код:

plugins/hClansPvPAddon/config.yml

Стандартная структура:

Код:

settings:
  defaultPvpEnable: false
  command:
    visibleInTabComplete: true
    aliases:
      enable:
        - "enable"
      disable:
        - "disable"
  permissions:
    toggle:
      ownerAlwaysAllowed: true
      clan:
        enable: false
        permission: hclanspvp.toggle
  damage:
    enable: true
    projectiles: true
    worlds:
      mode: blacklist
      list: []
    notify:
      attacker: true
      victim: false
      cooldownMillis: 5000

────────────────────────────────────────

Actions

Настраиваемые секции actions:

Код:

storageError
notInClan
noPermission
usage
enable
disable
damageCancelledAttacker
damageCancelledVictim

Они используются для команд, ошибок доступа и сообщений при заблокированном уроне.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Команды

Код:

/clan pvp
/clan pvp enable
/clan pvp disable

/clan pvp открывает GUI управления PvP.

/clan pvp enable включает урон между соклановцами.

/clan pvp disable выключает урон между соклановцами.

Алиасы enable и disable настраиваются в config.yml.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Права

hClansPvPAddon может использовать клановое право из системы прав hClans.

Стандартное настраиваемое клановое право:

Код:

hclanspvp.toggle

По умолчанию проверка кланового права выключена, а владелец клана всегда может переключать PvP.

Настройки:

Код:

settings:
  permissions:
    toggle:
      ownerAlwaysAllowed: true
      clan:
        enable: false
        permission: hclanspvp.toggle

Важно: это клановое право hClans, а не отдельное Bukkit permission для самостоятельной команды.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Требования

Java 17 или новее.
Сервер, совместимый с Bukkit / Spigot / Paper.
Плагин hClans.

Важно: hClansPvPAddon является аддоном и требует установленный hClans.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка

Установите hClans.
Поместите hClansPvPAddon.jar в папку plugins.
Запустите или перезапустите сервер.
Откройте созданные конфигурационные файлы.
При необходимости настройте config.yml и gui.yml.
Перезапустите сервер или перезагрузите hClans/аддоны привычным способом.

Файлы конфигурации:

Код:

plugins/hClansPvPAddon/config.yml
plugins/hClansPvPAddon/gui.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Примечания

Аддон регистрирует pvp как подкоманду клана.
PvP-состояния клана сохраняются постоянно.
Персональные состояния пары хранятся отдельно от общего состояния клана.
GUI можно полностью изменить через gui.yml.
Ограничения по мирам влияют только на логику контроля урона.
Обработку снарядов можно выключить в конфиге.

Зависимости: hClans - ОБЯЗАТЕЛЬНО

Команды и права: Выше

Плагин hClansPvPAddon [1.16.X-26.X] | Дополнение для плагина hClans v1.2

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Последние обновления

Фиксы!

Глобальное обновление!

Мы ценим вашу конфиденциальность