Consulta de UUID do Minecraft

A UUID (Universally Unique Identifier) é o identificador fixo de 128 bits de uma conta Minecraft Java, escrito com 32 caracteres hexadecimais. Com hífens (8-4-4-4-12, formato de whitelist.json, ops.json e usercache.json) ou sem hífens (formato da API da Mojang), o valor é o mesmo; a ferramenta mostra e aceita os dois formatos. Os servidores usam a UUID para a whitelist, operadores e banimentos, para os dados dos jogadores (a partir da versão 26.1 em world/players/data/<uuid>.dat; antes, em world/playerdata/<uuid>.dat) e para estatísticas. Plugins como LuckPerms também a usam para associar permissões e dados.

O jeito mais rápido é inserir o nome do jogador na ferramenta acima. No seu próprio servidor, você também pode encontrá-la em usercache.json (nomes e UUIDs de jogadores que já entraram) e no log, que registra uma linha como “UUID of player Notch is 069a79f4-44e9-4726-a5be-fca90e38aaf5” quando alguém entra. Com /data get entity @s UUID, o jogo mostra sua UUID como um array de inteiros. Se a ferramenta não encontrar resultados, confira a grafia: um nome Java tem de 3 a 16 caracteres (algumas contas antigas podem ter menos) e contém letras de A a Z sem acentos, números e sublinhados. A busca não diferencia maiúsculas de minúsculas e, para nomes sem conta Java, a ferramenta ainda mostra a UUID offline.

Não. Você altera o nome no seu perfil em minecraft.net, mas a UUID permanece a mesma. Por isso, a lista de permissões, as permissões e os dados do jogador são preservados, já que os servidores os associam pela UUID. Você só precisa atualizar as entradas que ainda contêm o nome antigo.

Se um servidor estiver em execução com online-mode=false, ele não poderá consultar os jogadores na Mojang. Em vez disso, calculará a UUID a partir do nome: o hash MD5 de “OfflinePlayer:<Name>” gera uma UUID de versão 3. Para “Notch”, o resultado é b50ad385-829d-3141-a216-7e7d7539ba7f, bem diferente da UUID real. O cálculo diferencia maiúsculas de minúsculas. Ao mudar o modo, os dados do jogador passam a estar associados a outra UUID. Inventário, progresso e estatísticas ficam indisponíveis até você renomear os arquivos na pasta do mundo para a nova UUID (com o servidor parado e um Backup): a partir da versão 26.1, em world/players/data, world/players/advancements e world/players/stats; em versões anteriores, em world/playerdata, world/advancements e world/stats.

Em 2022, a Mojang removeu da API pública a consulta de nomes anteriores; o endpoint antigo agora retorna apenas “Not Found”. A medida protege a privacidade dos jogadores. Desde então, não há uma fonte oficial para o histórico de nomes. Sites que ainda mostram nomes anteriores usam dados coletados por conta própria, incompletos e pouco confiáveis. Por isso, esta ferramenta mostra apenas o que a Mojang confirma publicamente: o nome atual associado a uma UUID e vice-versa.

Não, a ferramenta funciona apenas com a Java Edition. Contas Bedrock são identificadas pelo gamertag do Xbox e pela XUID. Em servidores com Geyser e Floodgate, jogadores Bedrock recebem uma UUID derivada da XUID que começa com 00000000-0000-0000. A API da Mojang não consegue consultar essas UUIDs.

Os dados vêm diretamente da API pública da Mojang (api.minecraftservices.com e o servidor de sessões). São apenas dados públicos do perfil: nome, UUID e endereços da skin e da capa. A UUID é um identificador público, não uma senha; não é preciso fazer login para consultá-la. Para evitar o limite de consultas da Mojang, armazenamos os resultados em cache por até 10 minutos. Por isso, um jogador que acabou de mudar de nome pode aparecer brevemente com o nome antigo. Se a Mojang indicar um limite de consultas, espere um minuto e tente novamente.

Em um servidor no modo online, basta usar /whitelist add <Name>; o servidor resolve o restante automaticamente. Se quiser editar o arquivo diretamente, copie a entrada gerada pela ferramenta para whitelist.json, por exemplo, { "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch" }, e depois execute /whitelist reload. Em servidores com online-mode=false, a whitelist usa a UUID offline do jogador.