Плагін Minecraft Rankup

🔌 Про Rankup

Rankup — це плагін Minecraft для Bukkit/Spigot, який реалізує налаштовувану систему прогресії у вигляді сходинки рангів. Він надає GUI для перегляду кроків рангів, гнучку систему вимог, щоб керувати тим, коли гравці можуть просуватися далі, а також систему prestige для повторного прогресу. Плагін призначений для адміністраторів серверів, яким потрібен автоматизований і налаштовуваний спосіб підвищувати гравців по рангах.

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

Rankup вирішує проблему керування прогресією гравців (сходинкою рангів) без ручного підвищення. Він об’єднує визначення рангів, вимоги для просування та необов’язкові механіки prestige, щоб власники серверів могли задавати багатокроковий прогрес, прив’язаний до permissions і власних вимог.

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

• Налаштовувана сходинка рангів, визначена в rankups.yml.
• GUI, щоб гравці могли переглядати rankup і підтверджувати його.
• Система вимог для визначення умов кожного кроку рангу (наприклад, permissions, час гри, токени/значення, які надають плагіни вимог).
• Підтримка prestige з окремим prestiges.yml.
• Команди для перегляду списку рангів, виконання rankup на один або кілька кроків і перезавантаження конфігурації.
• Підтримка placeholder через механізм placeholder плагіна для повідомлень і GUI.
• Контроль доступу на основі permissions для команд і адміністративних функцій.

🧩 Для кого це

• Сервери Survival / SMP, що використовують прогресію або сходинку рангів.
• Сервери Prison або economy, які мають системи підвищення на основі кроків.
• Адміни серверів, яким потрібне просування по рангах на основі permissions із підтримкою GUI.

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

• Визначте послідовність рангів, яка автоматично вимагатиме більше часу гри або предметів, перш ніж гравець зможе просунутися далі.
• Використовуйте prestige, щоб скинути ранг гравця, але дати йому спеціальні нагороди або лічильники прогресу.
• Інтегруйте з плагіном permissions, щоб надавати або прибирати пов’язані з рангами permission nodes, коли гравець просувається далі.

⌨️ Команди

🔐 Permissions

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

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

• Завантажте JAR плагіна з офіційного ресурсу або зберіть його з вихідного коду.
• Помістіть JAR у каталог plugins/ вашого сервера.
• Запустіть або перезапустіть сервер і перевірте вивід консолі, щоб переконатися, що плагін завантажено.
• Використовуйте надані файли конфігурації (rankups.yml, prestiges.yml, locale/config) і команду перезавантаження, щоб застосовувати зміни під час роботи.

📦 Збірка з вихідного коду

• Проєкт містить Gradle wrapper; запустіть наданий gradlew build, щоб створити JAR плагіна в каталозі build/libs.

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

• Плагін використовує YAML-файли конфігурації (зокрема rankups.yml і prestiges.yml) для визначення рангів і prestige.
• Він надає механізм placeholder і підтримує placeholders для використання в повідомленнях і GUI.
• Плагін відкриває явні permission nodes для команд і адміністративний permission, щоб відтворити доступ OP.
• Вихідний код опубліковано під GPL-3.0.

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

Якщо вам потрібна налаштовувана сходинка рангів із підтримкою permissions, GUI та prestige, Rankup централізує визначення рангів і правила просування, щоб автоматизувати прогресію гравців без ручних підвищень.