AsLeaderBoard

Что такое AsLeaderBoard и зачем он нужен?

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

Этот плагин для сервера собирает статистику по деньгам (через Vault), убийствам и смертям (по стандартной статистике Minecraft) и показывает её в трёх форматах: красивый GUI-меню, форматированные списки в чате и живые голограммы прямо на спавне или в лобби. Всё это обновляется автоматически, без лагов и с полной кастомизацией под стиль твоего сервера.

AsLeaderBoard отлично подходит для PvP-арен, экономических SMP, призон-серверов - словом, везде, где рейтинг игроков добавляет азарта. Плагин AsLeaderBoard решает главную проблему: вместо кучи разных плагинов под каждый тип статистики - один инструмент с единой системой отображения. И всё это без БД и нагрузки на сервер.

Основные фишки

Тройная система отображения

• Интерактивное GUI - меню с иконками в инвентаре, по которому можно кликать
• Чат - топ-10 игроков с цветами, рангами и личным статусом
• Голограммы - живые таблицы в мире, например, прямо у варпа "Спавн"

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

По умолчанию включены три категории:

• Деньги (Money) - через Vault, подходит для любого экономического плагина (EssentialsX, CMI, CraftConomy)
• Убийства (Kills) - берётся из встроенной статистики игроков
• Смерти (Deaths) - туда же, для фана и челленджей

Можно комбинировать: выводить топ денег в одном месте, топ киллеров - в другом. А хоть все три в одном меню с табами.

PlaceholderAPI и 50+ плейсхолдеров

AsLeaderBoard дружит с PlaceholderAPI, что даёт огромный простор для кастомизации. Можно вставить данные лидерборда куда угодно - в табло, чат, скорборды, MOTD, сообщения о входе.

Примеры плейсхолдеров:

%asleaderboard_top_1_money_player%  - имя самого богатого игрока
%asleaderboard_player_money_rank%   - твой рейтинг по деньгам
%asleaderboard_player_kills_value%  - сколько у тебя убийств
%asleaderboard_player_Notch_money_value% - баланс конкретного игрока

В конфиге можно настроить сокращение чисел (например, $1.5M вместо 1500000), формат валюты, дефолтные значения для офлайн-игроков.

Производительность

Разработчик заявляет, что GUI открывается быстрее 50 мс, а данные кешируются на 5 минут (настраивается). Асинхронная загрузка не тормозит главный поток - сервер не будет лагать даже при частом открытии меню. Плагин AsLeaderBoard ест около 10 МБ памяти и не требует баз данных, только Vault и статистику игры.

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

Основные команды:

• /leaderboard или /lb - открыть GUI
• /leaderboard money - показать топ денег в чате
• /leaderboard kills - топ убийств
• /leaderboard deaths - топ смертей
• /leaderboard reload - перезагрузить конфиги (требуется asleaderboard.reload)

Права:

• asleaderboard.use - базовые команды (по умолчанию у всех)
• asleaderboard.gui - доступ к GUI (по умолчанию у всех)
• asleaderboard.reload - перезагрузка конфига (только для админов)
• asleaderboard.admin - все права сразу

Кастомизация

Плагин AsLeaderBoard предлагает 4 конфигурационных файла: config.yml, messages.yml, gui-items.yml, chat-formats.yml. Менять можно буквально всё:

• Цвета, заголовки, вступления к топам
• Материалы иконок в GUI (хоть изумруды, хоть алмазные мечи)
• Позиции предметов в слотах инвентаря
• Звуковые эффекты при кликах
• Формат чисел и валюты

Пример настройки чата:

chat:
  money:
    header:
      - "&6&l━━━━━ MONEY LEADERBOARD ━━━━━"
    entry: "&e#{RANK} &8" &f{PLAYER} &8- &a${VALUE}"

Совместимость и установка

Плагин поддерживает Spigot, Paper, Purpur от версии 1.16 до 1.21+ (но нужна Java 17+). Для работы обязательно нужны Vault и любой плагин экономики. PlaceholderAPI - опционально, но без него потеряется часть фишек.

Установка простая: кидаешь .jar в /plugins, устанавливаешь Vault и экономику, перезапускаешь сервер. Всё работает сразу. Для настройки - правишь конфиги и делаешь /leaderboard reload.

Важно знать

• Местоимения в плейсхолдерах чувствительны к регистру - имя игрока нужно указывать точно
• Плейсхолдеры рангов возвращают число без символа # (например, 15, не #15)
• Кеш обновляется каждые 60 секунд по умолчанию - это настраивается
• Если у игрока нет данных (баланс 0, нет убийств), может показываться N/A - тоже меняется в конфиге
• Для голограмм нужно использовать плагины вроде DecentHolograms или аналоги - AsLeaderBoard предоставляет только данные через PlaceholderAPI

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

Если собираешь PvP- или призон-сервер - AsLeaderBoard фактически мастхэв. На небольших проектах тоже пригодится, чтобы добавить конкуренции между игроками. Главное - не перебарщивать с количеством голограмм в одном чанке, чтобы избежать лишней нагрузки.

Скачать AsLeaderBoard сложно назвать лишним - это одна из тех вещей, которые делают сервер "живым" и показывают игрокам их прогресс. Ну а возможность вывести топ в чат или на табло только усиливает мотивацию.