🌟 WarpBonus

WarpBonus — это дополнительный плагин (расширение) для AxPlayerWarps, добавляющий систему бонусных варпов для игроков.
Он автоматически пересчитывает количество доступных варпов при изменении группы через LuckPerms, а также позволяет вручную выдавать, изменять и проверять бонусные варпы.

Плагин протестирован только для Paper 1.21.8.

---

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

• 💾 Хранение количества бонусных варпов для каждого игрока
• 🔄 Автоматический пересчёт лимита при изменении группы (LuckPerms events)
• 💬 Команда /warpbonus для управления бонусными варпами
• 🧩 Полная совместимость с AxPlayerWarps
• 🧠 Корректная обработка лимитов из групп LuckPerms (учитываются только групповые пермишены)

---

🧱 Зависимости

• LuckPerms — обязательно
• AxPlayerWarps — обязательно

---

🚀 Установка

1. Убедитесь, что на сервере установлены LuckPerms и AxPlayerWarps.
2. Скачайте последний релиз из раздела Releases
3. Скопируйте WarpBonus.jar в папку plugins/.
4. Перезапустите сервер.
5. В консоли должно появиться сообщение:

   [WarpBonus] Плагин WarpBonus успешно запущен!

---

🧩 Команды

Команда	Описание
/warpbonus add <игрок> [количество]	Добавить игроку бонусные варпы (по умолчанию +1)
/warpbonus set <игрок> <количество>	Установить точное количество бонусных варпов
/warpbonus check <игрок>	Проверить текущее количество бонусных варпов
/warpbonus list	Показать список всех игроков с бонусными варпами

Пример:

/warpbonus add Player 2

Результат:

[WarpBonus] Игрок Player теперь имеет 5 бонусных варпов!

---

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

Permission	Описание	По умолчанию
warps.bonus.manage	Доступ к управлению бонусными варпами	op

---

🔄 Автоматические обновления лимитов

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

• при повышении или понижении группы (UserPromoteEvent, UserDemoteEvent);
• при изменении пермишенов группы (NodeAddEvent, NodeRemoveEvent);
• при входе игрока на сервер.

---

💾 Формат хранения данных

Файл: plugins/WarpBonus/bonus_warps.dat

Формат:

<UUID>:<количество>

Пример:

b62c71b9-6b3d-4e2e-9fd1-28e7d9f95aab:3
c8c12a87-9d53-42a4-bc63-9c2a497b4e59:1

---

🧠 Принцип работы

1. Плагин получает групповой лимит варпов из прав LuckPerms (axplayerwarps.warps.X).
2. Добавляет к нему количество бонусных варпов игрока.
3. Выдаёт игроку итоговый пермишен axplayerwarps.warps.<итого>.

Пример:

• У группы: axplayerwarps.warps.3
• У игрока: бонус +2
• Итоговый пермишен: axplayerwarps.warps.5

---

📜 Лицензия

Проект распространяется под лицензией MIT.
Вы можете свободно использовать и изменять плагин с указанием автора.