Statistic Books

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

Датапак позволяет отслеживать любые и все статистики или другие цели счета (scoreboard objectives) и отображать их в книге на кафедре. Система автоматически сортирует данные по самым высоким значениям, показывая тех, кто обладает лучшим результатом.

Все статистические данные отслеживаются через цели счета. Из-за этой особенности они не могут начать учитываться до момента их создания. Рекомендуется устанавливать датапак и создавать цели счета сразу при создании мира или сразу после него.

Если вы добавите датапак позже, данные не будут подтянуты автоматически для прошлых действий. Чтобы синхронизировать новые цели счета с уже имеющимися статтистиками, можно использовать инструменты для переноса данных в цели счета (stats to scoreboards tool).

Система работает по следующим правилам:

• Данные обновляются не в реальном времени, а максимум раз в 5 минут.
• Игроки, которые не были в сети как минимум 5 минут, могут не попасть в записи.
• В книге могут отображаться только те игроки, которые были в сети более 5 минут после создания книги.
• Обновление происходит только для книг, размещенных на кафедре.

Чтобы создать рабочую книгу, возьмите любую книгу, которую можно редактировать, и впишите название цели счета, которую вы хотите отслеживать, на первую страницу (без пробелов и переносов строк). Затем подпишите книгу именем "MCStats".

При первом помещении в кафедру книга конвертируется автоматически. Вы поймете, что всё работает, когда содержимое страницы заменится статистикой (сначала она может быть пустой, так как требуется до 5 минут для заполнения).

Вы можете отслеживать любую цель счета, включая те, что вы создали самостоятельно. Датапак поставляется с функцией, которая создает почти 8000 всех возможных типов статистик. Чтобы добавить их, выполните команду /function sb:setup_objectives сразу после загрузки датапака.

Названия целей в датапаке следуют соглашению sb.<B>.<D>, где B и D соответствуют частям пути из ванильных названий.

Если функция включена в настройках, игроки могут активировать секретный режим для любой книги на кафедре, стоя на ней и выполняя команду /trigger sb.secret. Это переключает книгу между тремя режимами:

• По умолчанию: отображается всё.
• Скрытые имена: имена скрыты, очки видны.
• Скрытые очки: имена видны, очки скрыты.

Настройки хранятся в цели счета sb.settings и могут быть изменены игроками с правами оператора (OP) уровня 2 и выше через команду /scoreboard players set sb.settings.

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

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