🌟 BonusAxWarp

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

Плагин написан для Paper 1.21+.

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

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

Пример:

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

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

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

🧱 Обязательные Зависимости

• LuckPerms
• AxPlayerWarps

🚀 Установка

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

🧩 Команды

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

Пример:

/bonusaxwarp add Player 2

Результат:

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

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

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

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

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

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

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

Файл: plugins/BonusAxWarp/bonus_warps.yml

Формат:

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

Пример:

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

📜 Лицензия

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