Donut Leaderboard
Кто на сервере богаче всех? Кто накопал больше блоков, наиграл больше часов или настрелял больше мобов? Если вы админ Minecraft-сервера, то наверняка слышали такие вопросы в чате. Donut Leaderboard решает эту задачу раз и навсегда: это отдельный плагин таблиц лидеров, который превращает сухие цифры статистики в удобное меню с головами игроков, рангами и переключением периодов.
Плагин работает на Spigot, Paper, Purpur и Folia, а поддерживаемые версии Minecraft охватывают диапазон от 1.20.1 до 26.3. Один лёгкий jar-файл закрывает весь этот список — не нужно искать отдельные сборки под каждое ядро.
Что умеет Donut Leaderboard
По сути, это полноценная система рейтингов с графическим интерфейсом. Игрок вводит /leaderboard, /lb, /top или /leaderboards — и попадает в категорийное меню, где собраны все доступные таблицы. Никаких сложных синтаксисов команд запоминать не нужно.
Категорийное меню и таблица лидеров
- Меню категорий в виде сундука со всеми встроенными и пользовательскими таблицами
- Постраничная таблица на шесть рядов с головами игроков
- Отдельное оформление для первых трёх мест
- Слот с вашим собственным рангом — видно, где вы находитесь, даже если вас нет на текущей странице
- Кнопки перелистывания страниц и возврата в меню категорий
- Переключатель периодов прямо внутри интерфейса
Открыть можно только один инвентарь лидерборда на игрока, а все клики, перетаскивания, обмены через цифровые клавиши и двойные клики блокируются. Это защищает от кражи и дюпа предметов.
Периоды: день, неделя, месяц и всё время
Каждую категорию можно смотреть в четырёх периодах: daily, weekly, monthly и all-time. Переключение — кнопкой с часами в GUI. Границы периодов считаются по часовому поясу из настройки periods.timezone, так что сбросы происходят в удобное для вашего сообщества время. Администраторы могут вручную обнулить категорию командой /lb reset <category> <period>.
Встроенные и пользовательские категории
Из коробки доступны баланс через Vault, убийства, смерти, время в игре, добытые блоки, убийства мобов, разведение животных, пойманная рыба и нанесённый урон. Этого хватает большинству серверов, но если нужно больше — подключайте PlaceholderAPI.
Любой плейсхолдер PlaceholderAPI можно превратить в отдельную таблицу лидеров. Плагин включает собственное расширение с идентификатором donutleaderboard, которое отдаёт ранг зрителя, имя, значение и номер позиции для любого места в топе. Эти данные удобно выводить в скорбордах, голограммах, табе и чате.
Кстати, если не хочется возиться с ручной загрузкой файлов, в лаунчере foxygame.net Donut Leaderboard ставится буквально в один клик: каталог дополнений сам подберёт сборку под вашу версию Minecraft и загрузчик, а обновления прилетают автоматически.
Хранение данных и производительность
По умолчанию используется SQLite — идеальный вариант для небольших серверов и простых установок, работает сразу без внешней инфраструктуры. Для крупных проектов и сетей серверов предусмотрен MySQL с пулом соединений HikariCP и автоматическими миграциями схемы. Драйверы баз данных объявлены как серверные библиотеки и скачиваются при первом запуске, поэтому сам jar весит около 100 КБ.
Ранжирование выполняется асинхронно: обновления кэша идут в фоновом исполнителе, чтобы главный поток и региональные потоки Folia оставались свободными. Интервал обновления настраивается через cache.refresh-seconds (минимум 15 секунд), а дублирующиеся обновления одной и той же таблицы исключаются.
Команды и права
- /leaderboard — открыть меню категорий, право donutleaderboard.use
- /lb open [category] [period] — открыть конкретную таблицу
- /lb rank <player> <category> [period] — показать ранг игрока
- /lb reload — перезагрузить конфиг и сообщения
- /lb reset <category> <period> — сбросить сохранённые очки за период
- /lb refresh [category] [period] — принудительно обновить рейтинг
Права use и rank выданы всем по умолчанию, административные — операторам. Все команды поддерживают автодополнение по Tab.
Как установить Donut Leaderboard
Установка максимально простая. Скачайте Donut Leaderboard для Minecraft, положите jar в папку plugins и перезапустите сервер. Плагин сразу заработает на SQLite со стандартными категориями. Дальше при желании настройте категории, ряды и слоты GUI, материал заполнителей, тип хранилища, часовой пояс периодов и сообщения в формате MiniMessage или с легаси-кодами цвета. Конфиги обновляются автоматически при добавлении новых опций, так что апгрейды не затирают ваши настройки.
Требования скромные: сервер Spigot, Paper, Purpur или Folia на Minecraft 1.20.1–26.3 и Java 17 или новее (для серверов 26.3 — Java 25). Опционально нужны Vault с совместимым экономическим плагином для таблицы баланса и PlaceholderAPI для пользовательских рейтингов.
Итог
Donut Leaderboard — это аккуратный и безопасный способ показать игрокам, кто в чём лучший. Понятный GUI, четыре периода, гибкие категории через PlaceholderAPI, асинхронный кэш и защита от дюпа делают его отличным выбором как для маленького ванильного сервера, так и для крупной сети. Один jar, широкая совместимость версий и минимальный вес — что ещё нужно для здоровой конкуренции среди игроков.