Введение: два игрока — один UUID

Ошибка «UUID mismatch» возникает, когда два игрока (или один игрок с разных клиентов) имеют одинаковый UUID, но разные имена, или наоборот. Это типичная проблема серверов с online-mode=false, где UUID генерируется на основе ника. Игроки могут терять инвентари, получать доступ к чужим данным или не мочь зайти на сервер. В этом гайде — как работает система UUID и как решать конфликты.

Как работают UUID в Minecraft

• Online-mode (лицензия): UUID выдаётся серверами Mojang при покупке игры. Он уникален и не меняется при смене ника. Сервер запрашивает UUID у Mojang при входе игрока.
• Offline-mode (пиратка): UUID генерируется сервером на основе ника игрока (оффлайн-UUID). Если два игрока с одинаковым ником заходят на сервер — у них одинаковый UUID, одинаковый инвентарь и местоположение.

Проблема 1: Смена ника (online-mode)

Игрок сменил ник через официальный сайт Mojang. UUID остался прежним, но серверные плагины могут кэшировать старый ник. Игрок заходит под новым ником, но плагины видят старый.

Решение:

• Плагины обычно сами обновляют кэш имён (LuckPerms, EssentialsX делают это автоматически).
• Если нет — перезапустите сервер или очистите кэш плагина.

Проблема 2: Одинаковые ники (offline-mode)

Игроки с одинаковыми никами не могут зайти одновременно — второй получает ошибку «Already logged in». Или первый игрок теряет инвентарь, когда заходит второй.

Решение:

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

Проблема 3: Перенос игроков с offline на online

При смене режима сервера с offline на online все UUID меняются, и игроки теряют инвентари.

Решение:

• Используйте конвертер UUID: Offline2Online UUID Converter (скрипт или плагин).
• Он сопоставляет старые оффлайн-UUID с новыми онлайн-UUID и переименовывает файлы playerdata.

💡 Совет профи

Используйте плагин FastLogin для гибридного режима. Игроки с лицензией заходят автоматически (проверка через Mojang), игроки без лицензии — через пароль (AuthMe). Сервер работает в online-mode=false, но лицензионные игроки получают свои настоящие UUID и скины. Это лучший компромисс для серверов с пиратками.