ScoreFixer

ScoreFixer — это техническая библиотека, которая решает проблему потери прогресса в таблицах счета из-за привязки очков к никнеймам, а не к UUID.

Датапак ScoreFixer предотвращает потерю значений таблицы счета (scoreboard), которые в Minecraft привязаны к никнеймам пользователей, а не к их уникальным идентификаторам UUID. Если игрок меняет имя, его предыдущие очки сбрасываются, что может сломать механику других датапаков или привести к потере прогресса. ScoreFixer решает эту проблему, позволяя автоматически переносить данные на новое имя без конфликтов.

• Автоматический перенос значений определенных целей (objectives) таблицы счета на новое имя игрока.
• Возможность чтения и записи очков офлайн-игроков с использованием их UUID или специфических значений (например, ID счета) в качестве селекторов.
• Наличие специальных тегов функций для событий: #score_fixer:changed_name, #score_fixer:joined_game и #score_fixer:left_game.

Чтобы ScoreFixer начал автоматически переносить цели (например, "foo" и "bar") при смене имени, выполните следующую команду:

/function score_fixer:util/track_objectives {Objectives:["foo", "bar"]}

Чтобы прекратить отслеживание этих целей, используйте команду:

/function score_fixer:util/untrack_objectives {Objectives:["foo", "bar"]}

Также можно напрямую добавлять или удалять {Name:"foo"} в данные хранения score_fixer:objectives List.

Вы можете получить доступ к очкам офлайн-игроков по их UUID с помощью функции загрузки:

/function score_fixer:util/load_with_uuid {UUID:...}

Если игрок найден, его данные копируются в score_fixer:loaded Players. После внесения изменений (корректировка очков или сброс целей) необходимо сохранить данные командой:

/function score_fixer:util/save

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

/data modify storage score_fixer:loaded Players append from storage score_fixer:zprivate Maps[{Objectives:[{Name:"foo",Value:10}]}]

Датапак предоставляет доступ к данным событий через теги функций и макросы. Содержимое хранилища score_fixer:event Data включает параметры Name, OldName и UUID.

• #score_fixer:changed_name — выполняется от имени игрока при входе с новым именем.
• #score_fixer:joined_game — выполняется от имени игрока при входе в игру.
• #score_fixer:left_game — выполняется при выходе игрока из игры.

Для удаления ScoreFixer выполните команду:

/function score_fixer:uninstall

При обновлении текущей версии рекомендуется сначала выполнить команду удаления, затем заменить файлы датапака и выполнить /reload. Начиная с версии 1.2.0, обновление на более поздние версии можно проводить без предварительного удаления.

Очки, установленные вручную, пока игрок находится в офлайне (например, через /scoreboard players set), не могут быть перенесены при смене имени. Для таких случаев используйте утилиты load и save.

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

Перенос очков также может не сработать в одиночной игре, если новое имя отличается от старого только регистром букв (например, Steve и steve), так как стандартные команды игры автоматически приводят никнеймы к единому регистру.

ScoreFixer поддерживает систему Lantern Load для управления зависимостями и порядком загрузки. Важно, чтобы ScoreFixer загружался и работал раньше вашего датапака. Это можно обеспечить, указав его как зависимость и заменив стандартный #minecraft:tick на самозапускаемую функцию тика.

• Оценка #ScoreFixer load.status: показывает статус загрузки (1 — успешно, 0 — ошибка загрузки, -1 — несколько несовместимых версий, -2 — попытка загрузки старой версии поверх новой, -3 — попытка загрузки неизвестной версии).
• Оценка #ScoreFixer.Version load.status: отображает текущую установленную версию проекта.