StatsPlugin - GUI-статистика и топы для сервера Майнкрафт

StatsPlugin - плагин для серверов Майнкрафт на Paper и Spigot, который выводит всю статистику игрока в аккуратное внутриигровое меню. Никаких команд в чате и ковыряния в файлах: жмёшь /stats - и видишь картину целиком. Если вы держите сервер и хотите, чтобы игроки сами смотрели свои достижения и мерялись счётчиками, это как раз тот случай. По духу штука близка к серверным хабам с топами, только встроена прямо в игру и не требует сторонних костылей.

Зачем это нужно

На любом более-менее живом сервере рано или поздно начинается одно и то же: кто больше набил убийств, кто дольше наиграл, кто больше накопил. Раньше это решали вручную или сторонними веб-панелями. StatsPlugin закрывает вопрос из коробки - открыл меню и всё на виду. Причём смотреть можно не только на себя, но и на любого другого игрока, даже если он сейчас офлайн.

Что умеет плагин

• /stats - открыть собственное меню статистики
• /stats <player> - посмотреть чужую статистику, в том числе офлайн-игрока
• /stats top [stat] - серверная таблица лидеров с кликабельными категориями
• /stats reload - перезагрузка конфига без рестарта сервера
• Полная поддержка офлайн-игроков: убийства, смерти, время в игре и остальное считаются и для тех, кто не в сети
• Интеграция с Vault: автоматический учёт заработанных и потраченных денег
• Опциональное расширение PlaceholderAPI (%statsplugin_<stat>%)
• Доступ по правам для каждой подкоманды
• Асинхронная работа с базой данных - никаких просадок TPS из-за запросов статистики
• Аккуратный GUI с рамкой, топом, кнопкой обновления и кликабельными головами игроков

Какая статистика отслеживается

• Деньги (текущий баланс), заработано, потрачено
• Убийства, смерти, убийства мобов
• Время в игре
• Поставленные и сломанные блоки

Набор базовый, но закрывает главные запросы. Баланс, время и блоки - это то, что игроки реально спрашивают друг у друга и чем хвастаются.

Команды и права

Команда	Право	По умолчанию
/stats	statsplugin.use	true
/stats <player>	statsplugin.others	true
/stats top [stat]	statsplugin.top	true
/stats reload	statsplugin.reload	op

Ключи статистики для топа: kills, deaths, mob-kills, playtime, blocks-placed, blocks-broken, money-earned, money-spent.

Требования

• Paper / Spigot 1.21+
• Vault (опционально, включает учёт денег)
• Плагин экономики, например EssentialsX (опционально)
• PlaceholderAPI (опционально)

Установка

1. Скачайте jar-файл плагина
2. Закиньте его в папку plugins
3. Перезапустите сервер
4. По желанию отредактируйте plugins/StatsPlugin/config.yml, чтобы настроить интервал синхронизации топа

Важные нюансы и советы

Учёт денег включается только при наличии Vault и экономического плагина вроде EssentialsX - без них блок с балансом просто не будет наполняться. То же с PlaceholderAPI: плейсхолдеры вида %statsplugin_<stat>% работают только если сам PlaceholderAPI стоит на сервере. Если планируете выводить статистику на табло или в чат, без него не обойтись.

Отдельно стоит похвалить асинхронный доступ к данным. На серверах с десятками онлайн-игроков синхронные запросы к базе могли бы ронять TPS, а тут этого нет by design. Правда, при очень частой синхронизации топа всё равно стоит заглянуть в конфиг и выставить разумный интервал - лишние чтения ни к чему.

Плагин рассчитан на Minecraft Java 1.21.x, на более старых версиях работать не будет. Скачать StatsPlugin имеет смысл тем, кто хочет добавить серверу немного соревновательности без сложной настройки: поставил, перезапустил - и топы уже работают.

Если собираете сервер и ищете, с чего начать, это неплохой must-have в пару к EssentialsX. Для плагина это естественное окружение, и на BungeeHost весь комплект ставится в один клик.

Лицензия - MIT.