Minecraft plugin ajLeaderboards

🔌 Про плагін ajLeaderboards

ajLeaderboards — це плагін для Minecraft серверів, який дозволяє створювати гнучкі та настроювані leaderboards (таблиці лідерів) на основі значень PlaceholderAPI.

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

ajLeaderboards призначений для відображення топів з будь‑яких числових PlaceholderAPI‑значень. Плагін вирішує задачу створення leaderboard'ів для плагінів, які не мають вбудованого топу (наприклад, економіка, статистики, бали ігор).

• Підходить для відображення рахунків, вбивств, часу гри, балів мініігри тощо.
• Знімає необхідність писати окремий код для кожного плагіна: ajLeaderboards працює з будь‑яким плагіном, що надає числові PAPI placeholders.

⚙ Основні можливості

• Підтримка PlaceholderAPI як джерела значень для топів.
• Показ у вигляді: holograms (через сумісний холограм‑плагін), signs (плашки), heads (голови), armor stands, NPCs (Citizens).
• Timed leaderboards: alltime, hourly, daily, weekly, monthly, yearly (можливість створювати тимчасові топи).
• Підтримка відображення префіксів/суфіксів гравців у топах (підтримка плагінів, що дають префікси).
• Інтеграція зі стандартними віджетами (наприклад, DecentHolograms) через PlaceholderAPI placeholders.

🧩 Кому підійде

• Survival та RPG сервери, які хочуть показати статистику гравців.
• Мережеві хаби та сайд‑проєкти, де потрібні ознайомчі топи (economy, minigames, PvP).
• Адміністратори, які хочуть використовувати існуючі PAPI placeholders замість писати окремі рішення.

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

• Створити топ за кількістю вбивств: додати %statistic_player_kills% і показувати у hologram.
• Відображати топ гравців за балансом економіки (%vault_eco_balance%) разом із DecentHolograms.
• Робити щомісячні та щотижневі топи для івентів (timed leaderboards).

⚡ Особливості та підтверджені джерела

• Плагін офіційно присутній на Spigot та має вихідний код на GitHub.
• ajLeaderboards використовує PlaceholderAPI як основну залежність/джерело даних. (Деталі налаштування в офіційному Wiki). ()
• Плагін реєструється на bStats (метрики). ()

⌨️ Команди

Примітка: ці команди підтверджені в офіційній документації (wiki). Для повного списку команд див. документацію плагіна. ()

🔐 Права доступу (permissions)

Джерело: офіційна wiki підтверджує наявність цих permission‑вузлів. Деталі налаштування permission‑вузлів — у розділі Permissions на wiki. ()

⚙ Інсталяція

📥 Встановлення

• Завантажте .jar із офіційної сторінки (Spigot) або GitHub релізів. ()
• Скопіюйте .jar у папку plugins/ вашого сервера.
• Перезапустіть сервер (повний рестарт, не /reload).

📦 Залежності

• PlaceholderAPI — підтверджена залежність (ajLeaderboards використовує PAPI placeholders). ()
• Citizens — опціонально для відображення NPC як елементів leaderboard (wiki згадує Citizens у прикладах). ()
• Рекомендований hologram‑плагін (наприклад DecentHolograms) для відображення в холограмах через PlaceholderAPI (wiki рекомендує DecentHolograms як приклад). ()

🧾 Конфігурація

• Плагін має офіційну Wiki з інструкціями по налаштуванню (створення бордів, placeholders, timed types). ()
• Інформація про підтримку зовнішніх баз даних (MySQL/SQLite) не однозначно вказана в офіційних джерелах; подробиці відсутні в офіційній документації, яка була знайдена. (Якщо вам потрібна підтримка БД — див. GitHub/документацію проекту). ()

🧠 Додаткова інформація

Відомі конфлікти

• Можливі конфлікти при використанні з іншими плагінами, що змінюють ті самі placeholder'и або перехоплюють ті самі події — перевіряйте сумісність при встановленні.
• При використанні NPC переконайтесь, що Citizens актуальний і налаштований.

Обмеження

• ajLeaderboards працює за принципом парсингу PlaceholderAPI як гравця — placeholder має повертати чисте числове значення (можуть бути коми, але без тексту чи форматування). Це обмеження описане в офіційній wiki. ()

FAQ (вибране)

1. Як додати новий leaderboard?

• Використайте команду /ajlb add %placeholder%. Після цього плагін почне відстежувати значення для цього борду. ()

2. Як показати leaderboard у hologram?

• Скористайтесь PlaceholderAPI placeholders, наприклад %ajlb_lb_<board>_<number>_<type>_name% і %ajlb_lb_<board>_<number>_<type>_value% у вашому hologram‑плагіні (wiki містить приклад). ()

3. Чи збирає плагін статистику (bStats)?

• Так, плагін зареєстрований на bStats для збору базових метрик. ()

4. Чи є підтримка Discord?

• Розробник вказує можливість контакту через Discord (посилання доступне на сторінці плагіна / wiki). ()

5. Які типи timed leaderboards підтримуються?

• alltime, hourly, daily, weekly, monthly, yearly (wiki). ()

📚 Джерела

• Spigot resource (офіційна сторінка релізу та опис). ()
• Офіційна Wiki плагіна (документація та інструкції setup). ()
• Репозиторій GitHub (вихідний код, ліцензія). ()
• bStats (реєстрація плагіну для метрик). ()

Коротко: ajLeaderboards — легкий у налаштуванні spigot/plugin для Minecraft servers, який дозволяє створювати leaderboards з будь‑яких PlaceholderAPI значень і виводити їх через holograms, signs, heads або NPCs. Для повного списку команд і прав див. офіційну документацію плагіна. ()