UUID Fixer

Мод UUID Fixer для Minecraft — исправление идентификаторов игроков

UUID Fixer решает проблему с использованием хешированных имен вместо реальных идентификаторов на серверах Minecraft в оффлайн-режиме. Мод автоматически проверяет аккаунты игроков через API Mojang и подставляет корректные UUID. Это необходимо для работы систем, привязанных к уникальным идентификаторам: торговля с жителями, сохранение питомцев, достижения и плагины вроде Essential.

Как мод решает проблему

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

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

Техническая реализация

В основе работы лежит миксин UUIDUtilMixin, который перехватывает создание оффлайн-UUID и заменяет его на реальный, если он получен. Для получения данных используется сервис UuidLookupService, который обращается к api.mojang.com с таймаутом 2 секунды. Это гарантирует, что даже при медленном интернете сервер не зависнет навсегда, а лишь задержит первый вход игрока на пару секунд.

Для ускорения работы мод использует кэш UuidCache. Результаты проверок (как успешные, так и подтверждённые провалы) сохраняются в файле config/uuidfixer/cache.json. Это означает, что повторные входы одного и того же игрока не требуют нового обращения к API, что снижает нагрузку на сервер и сеть.

Ограничения и особенности

Мод работает исключительно на стороне сервера. Клиенту ничего устанавливать не нужно. Если проверка UUID не проходит по какой-либо причине, мод не блокирует игрока и не вызывает ошибок — он просто не применяет исправление для этого конкретного пользователя. Также стоит учитывать, что мод не может восстановить UUID для аккаунтов, которые не являются премиум-подписками, так как API Mojang требует их для выдачи идентификаторов.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Craft Config Lib — похожий мод

Автор: xkat · Лицензия: MIT