Minecraft plugin PlayerStats

🔌 Про плагін PlayerStats

PlayerStats — це плагін для Minecraft серверів, який дозволяє переглядати ванільні статистики гравців у вигляді топ‑10, індивідуальних статистик або сумарних значень сервера.

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

PlayerStats вирішує задачу швидкого доступу до вже наявних у світі Minecraft статистик (ванільні statistics). PlayerStats дозволяє отримати лідерборди і детальні значення без додаткових баз даних або складного налаштування.

• PlayerStats читає стандартні файли статистики Minecraft і відображає їх користувачам.

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

• Одна центральна команда для перегляду статистик (/statistic).
• Показ топ‑10 гравців за будь‑якою ванільною статистикою.
• Перегляд статистик конкретного гравця.
• Виведення сумарних серверних значень (server total).
• Інтелектуальне таб‑автозаповнення та читабельне форматування з hover‑підказками.
• Можливість поширити (share) результати в чаті.
• Підтримка PlaceholderAPI через окремий expansion.
• Мульти‑тредінг для мінімального впливу на продуктивність сервера.
• Налаштування назв статистик через language.yml та інші опції локалізації.

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

• Survival та RPG сервери, які хочуть показувати гравцям їхні ванільні рекорди.
• Сервери, що використовують Paper/Spigot/Purpur.
• Проєкти, які не хочуть впроваджувати бази даних для простих лідербордів.

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

• Гравець вводить /statistic mine_block top щоб побачити топ‑10 з найчастіше добутих блоків.
• Адміністратор використовує PlayerStats для швидкої перевірки, хто має найбільше вбивств або пройденої дистанції.
• Інтеграція з PlaceholderAPI (через expansion) для показу статистик у табличках або в GUI.

⌨️ Команди

Примітка: офіційні джерела прямо згадують головну команду /statistic та команду для виключення; інші підкоманди можуть існувати як підкоманди /statistic.

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

⚙ Інсталяція

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

• Завантажити .jar плагіна з офіційного ресурсу (офіційна сторінка публікує релізи).
• Помістити .jar у папку plugins/ вашого сервера.
• Повністю перезапустити сервер (не рекомендується використовувати /reload).

📦 Залежності

• PlaceholderAPI — опційно, для використання placeholder‑expansion (є окреме expansion для PlayerStats).
• Немає потреби у Vault або інших сервісах для базового функціоналу.

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

• Плагін працює «з коробки» і не вимагає стартової налаштування.
• Наявність файлів локалізації (language.yml) дозволяє змінювати назви статистик і повідомлення.
• PlayerStats читає стандартні vanilla player stats файли — база даних (MySQL/SQLite) не потрібна.

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

Відомі особливості / обмеження

• PlayerStats використовує ванільні statistics — якщо в світі немає даних з певної статистики, її не буде у звітах.
• Плагін тестувався на платформах: Bukkit, Spigot, Paper, Purpur та на версіях Minecraft з 1.16.5 до 1.21.8 (згідно офіційних релізів).
• PlaceholderAPI‑expansion поставляється окремо (можна завантажити через /papi ecloud download PlayerStats або з GitHub expansion).

FAQ

Q: Чи потрібна база даних для PlayerStats? A: Ні — PlayerStats читає ванільні файли статистики; MySQL/SQLite не потрібні для базового функціоналу.

Q: Чи підтримує PlayerStats PlaceholderAPI? A: Так. Існує окремий PlaceholderAPI expansion для PlayerStats (доступний у eCloud та на GitHub).

Q: На яких ядрах працює PlayerStats? A: Офіційно тестовано на Spigot, Paper, Purpur та Bukkit (версії вказані вище).

Q: Чи плагін впливає на продуктивність сервера? A: PlayerStats використовує мульти‑тредінг для обробки статистик; це зменшує навантаження, але при дуже великій кількості гравців рекомендовано протестувати на staging‑сервері.

Телеметрія / інтеграція

• Інформація про використання bStats або іншу статистику використання відсутня в офіційних джерелах.
• Наявність офіційного Discord згадується на сторінці ресурсу, але прямі посилання на Discord‑сервер повинні братися з офіційної сторінки плагіна.

Коротко: PlayerStats — легкий, без бази даних, швидкий плагін для перегляду ванільних статистик та лідербордів на Spigot/Paper серверах. PlayerStats дозволяє показувати топи, індивідуальні статистики та інтегрувати дані у PlaceholderAPI.