LeaderBoards Datapack

Датапак предоставляет инструмент для размещения таблиц лидеров, ранжирующих игроков на сервере по выбранной цели Scoreboard.

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

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

Для создания новой таблицы используется команда:

/function leaderboard:_dialog/add_leaderboard_dialog

При настройке доступны следующие параметры:

• Scoreboard objective name — имя цели Scoreboard, которое будет отображаться. Оно должно в точности совпадать с именем цели (например, score_name, а не «My score»).
• Displayed Title — название, которое будет отображаться над таблицей.
• time_mode — режим отображения очков как времени (часы, минуты, секунды и тики). - Extended — сохраняет миллисекунды даже при значениях более 1 часа. - Stopwatch — оптимизировано для команды /stopwatch в версии 1.21.11. Требует время в миллисекундах. Пример получения времени: /execute store result score @p score_name run stopwatch query minecraft:foo 1000.
• reverse_order — инвертирует порядок игроков в таблице, ставя тех, у кого самый низкий счет, в начало.
• no_zero — исключает из таблицы игроков с нулевым счетом или отсутствием счета. Полезно в обратном режиме, чтобы новые игроки не оказывались в топе по умолчанию.
• billboard — тип отображения таблицы: vertical (вертикально), horizontal (горизонтально) или fixed (фиксированный). При типе fixed направление задается по направлению взгляда игрока, выполняющего команду. Можно использовать /tp @s ~ ~ ~ x y для фиксации угла.
• medal_color — добавляет цвета медалей для трех лучших позиций.
• show_heads — добавляет головы игроков рядом с их именами (доступно только в версиях 1.21.9+).
• always_show_closest_player — выделяет строку ближайшего игрока. Если этот игрок не входит в основной список (ограниченный параметром max_players), он будет добавлен в дополнительную строку под основным списком.
• bright — устанавливает постоянную полную яркость для текстовых дисплеев.
• Custom player list — продвинутая функция для отображения данных, не связанных напрямую с игроками (например, счета команд). Требует указания пути к хранилищу в формате <storage_name> <list_name>. Пример: my_storage:custom_namelist names.

Для работы с уже созданными таблицами используются следующие команды:

• Удаление ближайшей таблицы: /function leaderboard:commands/remove_leaderboard
• Редактирование ближайшей таблицы: /function leaderboard:_dialog/edit_leaderboard_dialog
• Удаление данных (Uninstall): /function leaderboard:commands/uninstall. В этом случае сохраняется только storage leaderboard:namelist на случай повторного включения.

Версии датапака до 1.21.6 сохраняют обратную совместимость, но больше не получают обновлений. Особенности использования старых версий доступны в репозитории автора.