🧰 ToolPicoTodas as ferramentas →

InícioBlog › Novidade: UUID offline do Minecraft

Novidade no Gerador UUID: mini-ferramenta de UUID offline do Minecraft

O Gerador UUID do ToolPico acabou de ganhar uma mini-ferramenta pedida com frequência por quem administra servidores Minecraft em modo offline: um cálculo direto do UUID a partir do nome de jogador, sem precisar de configurar manualmente nenhum namespace. Este artigo mostra exatamente o que mudou e como usar a novidade, com exemplos.

Índice

O que foi adicionado

Resposta rápida Foi adicionada uma mini-ferramenta chamada «UUID Minecraft (offline)» à secção de mini-ferramentas do Gerador UUID, que calcula o UUID de um jogador em modo offline a partir do MD5 da cadeia OfflinePlayer:<nome>, seguindo o mesmo método usado pelos servidores Minecraft com online-mode=false.

Até agora, a página já tinha três mini-ferramentas adicionais junto ao gerador principal: um gerador de UUID NIL (o valor fixo todo a zeros), um gerador ULID (identificador ordenável por Base32 de Crockford) e um conversor de UUID para Base64/Hex. A novidade junta-se a este grupo como quarta mini-ferramenta, e resolve um caso muito específico que não era coberto por nenhum dos modos existentes: reproduzir exatamente o algoritmo que um servidor Minecraft offline usa para atribuir UUID aos jogadores.

Antes desta atualização, quem precisasse deste cálculo tinha de o fazer à parte, fora da ferramenta — por exemplo com um script próprio que aplicasse MD5 manualmente. Agora, o mesmo resultado obtém-se diretamente na página, sem sair do navegador.

Como usar a nova mini-ferramenta

Resposta rápida Vai à secção «Mini-ferramentas adicionais» do Gerador UUID, encontra o cartão «UUID Minecraft (offline)», escreve o nome de jogador no campo de texto e clica em «Gerar UUID offline».

O funcionamento segue o mesmo padrão simples das outras mini-ferramentas da página: um campo de entrada, um botão, e um resultado que aparece logo abaixo. Neste caso, o único dado pedido é o nome de utilizador do jogador (o valor de exemplo já preenchido na ferramenta é «Notch», o nome do criador original do Minecraft, usado apenas como ilustração).

O que a ferramenta faz internamente: junta o prefixo fixo OfflinePlayer: ao nome introduzido, calcula o hash MD5 dessa cadeia de texto, e depois ajusta alguns bits específicos do resultado (os bits de versão e de variante) para que o valor final tenha o formato correto de uma UUID v3 válida — exatamente o processo que um servidor Minecraft em modo offline executa internamente para cada jogador.

Exemplo passo a passo

Resposta rápida Introduzir um nome de jogador na nova mini-ferramenta e clicar em «Gerar UUID offline» devolve sempre o mesmo UUID para esse nome exato — é um cálculo determinístico, não aleatório.

Um cenário prático (ilustrativo): imagina que administras um pequeno servidor Minecraft privado, para jogar com amigos, e o servidor corre em modo offline porque nem todos os jogadores têm conta Microsoft ligada. Um plugin de permissões pede-te o UUID de um jogador chamado Aventureiro77 para o adicionares manualmente a uma lista de administradores. Em vez de teres de esperar que o jogador entre no servidor para veres o UUID gerado nos registos, podes:

Como o cálculo depende inteiramente do nome introduzido (é sensível a maiúsculas/minúsculas e a qualquer caráter da cadeia), o mesmo nome escrito da mesma forma produz sempre exatamente o mesmo UUID — o que te permite preparar configurações antes mesmo de o jogador entrar pela primeira vez no servidor.

CampoO que fazes
Nome de jogadorEscreves o nome de utilizador exato usado no cliente Minecraft offline
Cálculo internoMD5("OfflinePlayer:<nome>") + ajuste de bits de versão/variante
ResultadoUUID no formato padrão, pronto a copiar para configs de plugins ou mapas de mundo

Quando (e quando não) usar isto

Resposta rápida Usa esta mini-ferramenta apenas se o teu servidor corre em modo offline (online-mode=false); para servidores online, o UUID real do jogador vem da conta oficial Mojang/Microsoft e não é calculado a partir do nome.

É importante não confundir os dois modos. Em modo online, o servidor verifica a conta oficial do jogador junto dos servidores da Mojang/Microsoft, e o UUID atribuído é o UUID real e permanente dessa conta — não tem nenhuma relação com o cálculo MD5 descrito aqui, e mudar de nome de utilizador não altera esse UUID (a conta é que é a fonte da verdade). Em modo offline, não há essa verificação, e por isso o servidor recorre ao cálculo determinístico a partir do nome — o mesmo que esta nova mini-ferramenta agora reproduz.

Isto é particularmente útil em três situações: servidores privados só para amigos sem contas oficiais para todos; servidores de testes/desenvolvimento de plugins, onde se quer um UUID previsível para automatizar testes; e migração ou auditoria de configurações antigas de servidores offline, onde já existem ficheiros com UUID mas falta saber a que nome cada um corresponde.

Aviso importante: nunca uses um UUID calculado em modo offline como se fosse o UUID de conta real de um jogador em serviços online (como whitelists partilhadas entre servidores online, ou verificação de propriedade de skins) — os dois valores não são intercambiáveis e tratar um pelo outro pode causar identificação incorreta de jogadores.

Experimenta agora a nova mini-ferramenta de UUID offline do Minecraft, junto com v4, v1, v3/v5, v7, ULID e muito mais.

Abrir o Gerador UUID →

Perguntas frequentes

Onde encontro a nova mini-ferramenta de UUID offline do Minecraft?
Está na página do Gerador UUID do ToolPico, na secção «Mini-ferramentas adicionais», junto ao gerador de UUID NIL, ao gerador ULID e ao conversor UUID⇄Base64/Hex. Basta escrever um nome de jogador no campo de texto e clicar em «Gerar UUID offline» para obter o resultado.
Esta mini-ferramenta funciona também para servidores online (com conta Mojang/Microsoft)?
Não. Esta mini-ferramenta calcula apenas o UUID de modo offline, derivado unicamente do nome de jogador introduzido. Um servidor em modo online consulta a conta oficial Mojang/Microsoft do jogador para obter o UUID real dessa conta, que normalmente não tem nenhuma relação com o valor calculado aqui. Usa esta ferramenta apenas se o teu servidor correr com online-mode=false.
Se eu mudar o nome de utilizador, o UUID offline muda?
Sim. Como o cálculo depende inteiramente da cadeia de texto do nome (incluindo maiúsculas e minúsculas exatas), um nome diferente produz sempre um UUID offline diferente — e o mesmo nome produz sempre o mesmo resultado. Isto significa que, em modo offline, mudar de nome de utilizador é, na prática, equivalente a tornares-te um «jogador» novo aos olhos do servidor e dos seus plugins.
Esta ferramenta guarda ou envia os nomes de jogador introduzidos?
Não. Tal como todas as restantes mini-ferramentas desta página, o cálculo do UUID offline do Minecraft (a aplicação do MD5 e o ajuste dos bits de versão/variante) corre inteiramente no teu navegador. Nenhum nome introduzido é enviado para um servidor, guardado ou registado em qualquer sítio.
Esta novidade substitui o separador «v3 / v5 Nome» já existente na ferramenta?
Não, são complementares. O separador «v3 / v5 Nome» serve para gerar UUID determinísticas com qualquer namespace RFC 4122 padrão (DNS, URL, OID, X.500) ou personalizado. A nova mini-ferramenta de UUID offline do Minecraft aplica um cálculo específico e fixo — MD5 sobre «OfflinePlayer:<nome>» — só para este caso concreto, poupando-te de configurar manualmente o namespace certo para replicar o comportamento de um servidor Minecraft offline.
Nota: este artigo descreve uma funcionalidade adicionada à ferramenta ToolPico e tem fins informativos sobre administração de servidores Minecraft; não substitui a documentação oficial do servidor Minecraft nem de plugins específicos. O nome de jogador usado como exemplo («Notch», «Aventureiro77») serve apenas para ilustração.