Statistic Books - книга статистики для Майнкрафт

Statistic Books - это датапак для Minecraft, который позволяет отслеживать любую статистику или другие цели из системы scoreboard прямо в игре. Всё выводится аккуратно в книгу, которая стоит на кафедре. Без модов, сложных плагинов и прочих заморочек.

Зачем это вообще нужно? В ванильном Minecraft нет нормального способа посмотреть, кто сколько набегал, сколько мобов убил или блоков сломал. Можно, конечно, лезть в меню статистики, но там всё разрозненно. А с этим датапаком ты просто подходишь к книге на кафедре - и видишь рейтинг игроков по выбранному критерию. Всё честно, автоматически обновляется и не требует админских навыков.

Как это работает

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

Важный момент: статистика начинает отслеживаться только после создания цели scoreboard. Она не захватывает данные задним числом. Поэтому лучше всего устанавливать датапак сразу при создании мира. Если мир уже живёт, используй встроенную функцию /function sb:setup_objectives - она создаст сразу около 8000 целей, чтобы синхронизировать статистику.

Как получить книгу

Берёшь обычную книгу с пером, пишешь на первой странице название цели scoreboard (без пробелов и переносов строк, например sb.custom.walk_one_cm), подписываешь её под именем "MCStats" - и ставишь на кафедру. Книга сама конвертируется и начнёт заполняться данными. Первое обновление может занять до 5 минут - это нормально.

Названия целей строятся по схеме: sb.<группа>.<событие>. Примеры:

• Пройдено пешком: sb.custom.walk_one_cm
• Сломано камня: sb.mined.stone
• Убито зомби: sb.killed.zombie

Ограничения

Поскольку система использует scoreboard, данные обновляются не мгновенно, а с интервалом до 5 минут. Офлайн-игроки попадают в книгу только если они были в сети хотя бы 5 минут до этого. Книги обновляются только когда стоят на кафедре.

Секретный режим

Можно сделать так, чтобы в книге скрывались имена игроков или очки. Полезно, если хочешь устроить тайное соревнование или просто не светить данные. Для включения просто стань на кафедру и введи /trigger sb.secret. На выбор три режима:

• Default - показывается всё
• Secret Names - имена скрыты, очки видны
• Secret Scores - имена видны, очки скрыты

Режим включается отдельно для каждой книги.

Настройки

Все настройки хранятся в цели sb.settings. Менять их может только оператор с уровнем 2 и выше через команду:

/scoreboard players set <название> sb.settings <значение>

Посмотреть текущие настройки можно командой /scoreboard objectives setdisplay sidebar sb.settings.

autoOptIn

По умолчанию: 1

• 1 - все игроки автоматически участвуют, отказаться нельзя
• 0 - игроки должны сами включиться командой /trigger sb.optin, иначе их статистика не собирается

Если переключить с 1 на 0, старые данные сохранятся, но обновляться не будут, пока игрок не подтвердит участие.

allowSecret

По умолчанию: 1

• 1 - игроки могут переключать секретный режим сами
• 2 - секретный режим включён, но менять его могут только админы через /function sb:admin/secret
• 0 - секретный режим отключён, но книги "помнят" свой статус, так что при повторном включении всё вернётся

refreshType

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

Значение	Тип	Описание
0	При открытии	Книга обновляется каждый раз, когда кто-то взаимодействует с кафедрой. Лучший вариант для серверов до 30 игроков.
1	Один триггер	Игрок стоит на кафедре и пишет /trigger sb.update - обновляется только эта книга.
2	Радиус	Команда /trigger sb.update обновляет все книги в радиусе 16 блоков от игрока.
3	Авто-таймер	Раз в 5 минут обновляются все загруженные кафедры. Не напрягает, работает само.
4	Только админ	Админы обновляют книги вручную командами /function sb:admin/one, /function sb:admin/area или /function sb:admin/all.

Работа с текстом

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

Идентификатор	Текст по умолчанию
sb.update.success	Lectern(s) updated.
sb.update.fail	No lectern found.
sb.book.title	Statistics Book
sb.book.lore.1	Automatically lists everyones statistic.
sb.book.lore.2	Needs to be placed in lectern.
sb.book.lore.3	Tracked statistic:
sb.opt_in	You have chosen to be included in the statistics.
sb.opt_out	You have chosen not to be included in the statistics. Your scores will be removed the next time the books are updated.
sb.secret.default	Secret Mode: No secrets.
sb.secret.names	Secret Mode: Names hidden.
sb.secret.scores	Secret Mode: Scores hidden.

Комбинирование целей

Если нужно собрать статистику из нескольких источников (например, общее количество шагов + пробежек), начиная с версии 1.5.1 можно зарегистрировать функцию в тег sb:run_before. Она выполняется as @a перед сохранением данных. Таким образом, ты можешь создавать составные scoreboard-цели на лету.

Для упрощения этой задачи используй утилиту Scoreboard Combiner.

Итог

Statistic Books - вещь полезная, если на сервере есть соревновательный элемент или просто хочется видеть, кто чем занимается. Не грузит сервер, настраивается гибко и не требует ничего, кроме самого датапака. Скачивай Statistic Books и используй для Minecraft 1.20+. Работает с PlayerDB и базовыми механиками - без конфликтов.