Início › Blog › Novidade: 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.
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.
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).
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.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:
Aventureiro77 no campo de nome da mini-ferramenta;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.
| Campo | O que fazes |
|---|---|
| Nome de jogador | Escreves o nome de utilizador exato usado no cliente Minecraft offline |
| Cálculo interno | MD5("OfflinePlayer:<nome>") + ajuste de bits de versão/variante |
| Resultado | UUID no formato padrão, pronto a copiar para configs de plugins ou mapas de mundo |
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.
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 →