XLeaderboards (Икс лидербордс)

Плагин для серверов Майнкрафт, который создаёт таблицы лидеров по любым показателям через плейсхолдеры. Можно вести дневные, недельные, месячные и постоянные топы, показывать место игрока и выдавать награды лидерам дневного рейтинга.

Возможности

• Топы по значениям из других плагинов: например, по монетам, убийствам или другой статистике, которую отдаёт плейсхолдер.
• Автоматическое сравнение и форматирование чисел.
• Место игрока и его значение в каждом рейтинге.
• Награды за места в дневных топах: команды, сообщения и сообщения по центру экрана задаются в rewards.yml.
• Хранение данных в SQLite или MySQL.
• Гибкая частота записи, обновления топов, лимит записей в памяти и размер пакетов обработки.

Команды

• /xlb gettop <timeType> <topKey> — выводит топ указанного типа.
• /xlb forceupdate <timeType> — принудительно обновляет топ.
• /xlb reload — перезагружает настройки плагина.

timeType принимает значения daily, weekly, monthly или permanent. Ключ topKey — имя топа из раздела tops в config.yml, например coins.

Права

• xleaderboards.gettop — доступ к /xlb gettop.
• xleaderboards.forceupdate — доступ к /xlb forceupdate.

Настройка

В config.yml для каждого топа укажите источник значения в placeholder и отображаемое имя в name. Например, placeholder: "%statistic_player_kills%" создаёт рейтинг по убийствам. Параметр cached-top-entries определяет, сколько позиций хранится и доступно для вывода.

Для вывода в голограммах и других элементах, работающих с PlaceholderAPI, используйте плейсхолдеры:

• %xleaderboard_top_<topName>;<timeType>;<valueType>;<index>% — игрок, значение или UUID позиции; вместо valueType укажите top_name, top_value либо top_uuid.
• %xleaderboard_ranking_<timeType>_<topName>% — место игрока.
• %xleaderboard_amount_<timeType>_<topName>% — значение игрока.
• %xleaderboard_update_cooldown_<timeType>% и %xleaderboard_reset_cooldown_<timeType>% — время до обновления или сброса.

Интервалы обновления задаются в topUpdates, а параметры базы данных — в разделе databases. Для голограмм подойдёт DecentHolograms или другой плагин с поддержкой PlaceholderAPI.

Требования

Для использования плейсхолдеров нужен PlaceholderAPI. Плагин поддерживает Folia; для отображения топов через голограммы требуется совместимый плагин, например DecentHolograms.