PVP-PVE Leveling System

Плагин добавляет систему прогрессии с XP, уровнями и наградами, интегрируясь с LuckPerms для множителей групп и PlaceholderAPI для отображения данных.

• Logo

PVP-PVE Leveling System — это функциональный инструмент для создания прогрессии на сервере. Система позволяет игрокам накапливать опыт (XP), повышать уровни и получать соответствующие награды за достижения. Плагин поддерживает хранение данных в базах SQLite и MySQL, а также предлагает гибкие возможности настройки множителей опыта на основе групп пользователей.

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

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

• PlaceholderAPI — обязательная зависимость
• LuckPerms — опциональная интеграция для множителей групп
• bstats — включено в состав

🎮 Команды

/leveling reload
/leveling <xp|level> <add|remove|set> <amount> <player>

📊 Placeholders (PlaceholderAPI)

Для корректной работы всех плейсхолдеров ниже необходимо наличие установленного плагина PlaceholderAPI.

• %pvppvelevelingsystem_xp% — текущее количество опыта игрока
• %pvppvelevelingsystem_level% — текущий уровень игрока
• %pvppvelevelingsystem_remaining_xp% — опыт, необходимый до следующего уровня
• %pvppvelevelingsystem_bar% — полоса опыта
• %pvppvelevelingsystem_level_percent% — прогресс уровня в процентах
• %pvppvelevelingsystem_next_level_xp% — требование опыта для следующего уровня
• %pvppvelevelingsystem_next_level% — следующий уровень

• PVP-PVE Leveling System — изображение проекта

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

В конфигурационном файле можно настроить следующие параметры:

• Языковые файлы: доступны en_us и fr_fr. Новые языки можно создать в папке /lang/.
• Хранилище: выбор между SQL и MySQL.
• Источники опыта: возможность задать числовые значения для конкретных мобов (zombie, skeleton, creeper, spider, blaze, enderman). Все остальные мобы по умолчанию дают 0 XP.
• Визуализация: настройка длины и символов полоски опыта (bar).
• Множители групп: интеграция с LuckPerms позволяет применять множители XP к основной группе игрока (например, VIP получает множитель 2.5).
• Масштабирование уровней: использование множителя для расчета требуемого опыта (baseXP + level * multiplier * baseXP) или ручное определение опыта для каждого уровня.
• Награды: автоматическое выполнение консольных команд при достижении определенных уровней.

При использовании множителей в секции levels-xp, если параметр use-multiplier установлен в false, будут использоваться вручную заданные значения для каждого уровня.

Пример структуры конфигурации для MySQL:

mysql:
  host: "localhost"
  port: 3306
  database: "leveling"
  username: "root"
  password: "password"

Плагин также поддерживает сбор статистики через bStats.