Плагін Minecraft AxRewards

🔌 Про AxRewards

AxRewards — це плагін Minecraft, що надає легку та налаштовувану систему нагород. Адміністратори сервера визначають нагороди з довільними cooldown, показують їх у редагованих GUI та запускають команди отримання, коли гравці забирають нагороди. Проєкт підтримується Artillex-Studios і включає зберігання на основі бази даних та підтримку кількох серверів.

🎯 Призначення

AxRewards вирішує поширену потребу в запланованих або повторюваних нагородах для гравців (наприклад, щоденні або щотижневі нагороди за вхід) і водночас пропонує гнучкі cooldown, блокування за permission та подання через GUI. Він призначений для серверів, яким потрібна інтегрована, налаштовувана система нагород без потреби у зовнішніх системах кешування.

⚙️ Можливості

• Налаштовувані нагороди з довільними cooldown (у секундах).
• Редаговані меню GUI для показу нагород; елементи GUI можуть показувати різні стани (можна забрати / не можна забрати / немає permission).
• Зберігання в базі даних із підтримкою H2, SQLite, MySQL і PostgreSQL.
• Підтримка кількох серверів без потреби в Redis.
• GUI з автоматичним оновленням (оновлюється періодично без повторного відкриття).
• Можливість блокувати нагороди за permission (кожна нагорода може вимагати permission).
• Дії отримання реалізовані як список серверних команд (підтримує placeholder %player%).
• Інтеграція PlaceholderAPI та підтримка кількох форматів кольорів.

🧩 Для кого це

• Сервери Survival і SMP, яким потрібні щоденні/щотижневі/кастомні нагороди, що можна забирати.
• Оператори серверів, яким потрібна стійкість даних на основі бази даних між перезапусками або на кількох серверах.
• Адміни, які надають перевагу поданню нагород через GUI та нагородам, заблокованим за permission.

🏗️ Приклади використання

• Запропонувати щоденну нагороду за вхід, яка видає предмети або запускає команди під час отримання.
• Надати щотижневі VIP-нагороди з обмеженням, які вимагають permission рангу для отримання.
• Запускати нагороди на основі команд, які дають гроші, предмети або виконують власні серверні команди з використанням %player%.

⌨️ Команди

(Перелічено лише команди, підтверджені в офіційній документації.)

⚙️ Встановлення

📥 Налаштування

• Завантажте JAR-файл плагіна та помістіть його в папку plugins/ вашого сервера для сервера, сумісного з Bukkit/Spigot/Paper.
• Запустіть або перезапустіть сервер, щоб плагін зміг створити свої папки даних і конфігурації.
• Файли конфігурації та меню розміщуються в папці плагіна (наприклад plugins/AxRewards/menus).

📦 Залежності

• PlaceholderAPI (необов’язкова інтеграція для placeholder) — підтримку підтверджено.

🧠 Технічні примітки

• Підтверджені бекенди баз даних: H2, SQLite, MySQL, PostgreSQL.
• Плагін підтримує PlaceholderAPI та поширені формати кольорів (зокрема MiniMessage і legacy-формати).
• GUI автоматично оновлюється (auto-updating) без потреби для гравців відкривати його знову.
• Нагороди задають cooldown у секундах; значення cooldown -1 означає, що нагорода ніколи не оновлюється.
• Проєкт є open-source і ліцензований під MIT.
• Підтверджені підтримувані серверні програми та теми включають Bukkit, Spigot, Paper і Folia.
• Підтверджена вимога: сучасне середовище Java (нотатки проєкту вказують на Java 21 або вище для нещодавніх релізів).

🤝 Коли цей плагін корисний

Якщо вам потрібна налаштовувана система нагород із керуванням через GUI, постійним зберіганням і підтримкою між серверами, AxRewards надає редаговані меню, обробку cooldown і дії отримання на основі команд, а також інтеграцію з PlaceholderAPI та поширеними базами даних.