Плагин для серверов Майнкрафт подставляет настоящий UUID аккаунта Mojang игрокам на серверах с online-mode=false. Это помогает сохранить привязку инвентаря, статистики и прав к UUID лицензионного аккаунта вместо офлайн-UUID.
Важно: плагин проверяет только существование ника в Mojang и не подтверждает владение аккаунтом. Любой игрок может зайти под чужим лицензионным ником и получить доступ к связанным с ним данным и правам, поэтому использовать плагин следует только на закрытом сервере с доверенными игроками.
Возможности
- Ищет UUID аккаунта Mojang при входе игрока.
- Сохраняет результаты в кэш
uuid-cache.ymlс настраиваемым сроком действия. - При недоступности API не блокирует вход: использует старую запись кэша или офлайн-UUID.
- Позволяет отдельно включить или отключить проверку для конкретного ника через
overrides.yml.
Команды
Базовая команда: /premiumuuid; сокращение: /puuid.
/premiumuuid reload— перечитатьconfig.yml./premiumuuid status <nick>— показать состояние кэша и персональное правило для игрока./premiumuuid clearcache [nick]— очистить весь кэш либо запись указанного игрока./premiumuuid enable <nick>— всегда проверять ник как лицензионный./premiumuuid disable <nick>— всегда назначать офлайн-UUID./premiumuuid reset <nick>— удалить персональное правило.
Права
Для всех команд нужна привилегия premiumuuid.admin, которая по умолчанию доступна операторам.
Настройка
Основной файл — plugins/PremiumUUID/config.yml.
premium-uuid-enabled— включает проверку UUID.mojang-api.timeout-ms— время ожидания ответа Mojang API.cache.file— имя файла кэша.cache.ttl-minutes— срок действия записи кэша в минутах.fallback.log-warning— выводить предупреждение при переходе на офлайн-UUID.logging.level— уровень журналирования:INFOилиDEBUG.
Персональные правила находятся в plugins/PremiumUUID/overrides.yml. Значение true всегда запускает проверку ника, false всегда оставляет офлайн-UUID; ник сохраняется в нижнем регистре.
Требования
Плагин предназначен для Paper-сервера с online-mode=false в server.properties.
