PVP Toggle

PVP Toggle предоставляет гибкую систему включения и выключения возможности участия в PvP для каждого игрока в отдельности. Поддерживает настройку состояний по мирам, интеграцию с LuckPerms и PlaceholderAPI.

PVP Toggle предназначен для настройки взаимодействия игроков в боевых ситуациях. Основная механика позволяет каждому пользователю самостоятельно определять, готов ли он к участию в PvP, в то время как администраторы сервера получают инструменты для принудительного изменения этих статусов.

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

Плагин включает в себя несколько ключевых функций для удобства управления сервером:

• Управление для игроков: пользователи могут менять свой статус через команду /pvp (поддерживаются аргументы on, off, toggle).
• Администрирование: администраторы могут изменять статус любого игрока и проверять текущее состояние PvP через /pvp status <player>.
• Разграничение по мирам: поддержка хранения независимых состояний PvP для каждого мира сервера.
• Оптимизация записи: использование механизма save-debounce для уменьшения частоты записи данных на диск.
• Визуальная и звуковая связь: настраиваемая обратная связь при переключении статуса, включая звуки, сообщения в ActionBar и заголовки (Title).
• Интеграция: плагин корректно работает с Folia (используя AsyncScheduler для асинхронного сохранения), LuckPerms для управления правами и PlaceholderAPI для вывода данных.

Команды

Права доступа

Настройка конфигурации

Файл config.yml содержит параметры для глубокой настройки поведения плагина:

• default-pvp: Состояние PvP по умолчанию для новых или неизвестных игроков (true/false).
• persist-on-rejoin: Сохранять ли выбор игрока при повторном входе на сервер.
• per-world: Хранить ли независимые состояния PvP для каждого мира.
• save-debounce-seconds: Задержка перед записью на диск в секундах (0 — сохранять мгновенно).
• command-cooldown-seconds: Перезарядка после переключения собственного статуса (0 — без перезарядки).
• toggle-feedback: Настройка уведомлений (звуки, ActionBar, Title).
• placeholder-on / placeholder-off: Значения, возвращаемые плейсхолдерами PlaceholderAPI.
• messages.*: Настройка всех сообщений с поддержкой цветовых кодов & и переменных %player%, %seconds%, %status%.

Интеграция с PlaceholderAPI

При наличии установленного PlaceholderAPI регистрируются следующие плейсхолдера:

По умолчанию плейсхолдеры возвращают значения on или off. Эти значения можно изменить в конфигурации через параметры placeholder-on и placeholder-off.