MC Toolkit

Guias / Comandos e dados

Um nome de usuário no Minecraft tem 1–16 caracteres de exatamente três tipos, e um UUID tem duas grafias

Letras, dígitos, sublinhado. Sem hífens, sem pontos, sem espaços. E um UUID é aceito com ou sem os traços — e é por isso que uma busca falha e a idêntica funciona.

Buscar uma skin significa transformar algo que alguém digitou em algo que a Mojang reconhece, e só existem duas possibilidades. Ambas têm regras precisas, e a do UUID tem uma particularidade que gera muitos relatos de "diz que não foi encontrado".

A regra do nome de usuário

^[A-Za-z0-9_]{1,16}$

Três classes de caracteres e nada mais: letras, dígitos, sublinhado. Comprimento de 1 a 16.

O que isso exclui é a parte útil:

  • sem hífens — a coisa mais comum que as pessoas tentam
  • sem pontos, sem espaços, sem @
  • nada acima de 16 caracteres, e nada vazio

Então um nome de exibição de um servidor, um arroba do Discord ou um e-mail não vão resolver, mesmo que pareçam nomes. Se uma busca falha e o texto contém um hífen, quase sempre é esse o motivo — e o hífen é justamente o caractere que faz as pessoas partirem para o outro formato.

A regra do UUID, e por que ele tem duas grafias

^[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{12}$

Repare em cada -?: cada traço é opcional. Estes dois são a mesma conta e ambos são aceitos:

069a79f4-44e9-4726-a5be-fca90e38aaf5      dashed
069a79f444e94726a5befca90e38aaf5          undashed

32 dígitos hexadecimais, agrupados em 8-4-4-4-12. Maiúsculas e minúsculas também não importam — A-F e a-f dão match igual.

Isso importa porque as duas formas vêm de lugares diferentes. Um usercache.json, a config de um plugin e a própria API da Mojang não entram em acordo sobre qual delas emitem — e um /data get em um jogador não imprime nenhuma das duas, mas sim um array de quatro inteiros ([I; …]) — então você vai encontrar as duas, e uma ferramenta que aceita só uma delas parece quebrada metade das vezes.

O -? é por separador, e não tudo ou nada, então uma string parcialmente com traços também passa. Isso é mais permissivo do que o estritamente correto, e de propósito: rejeitar uma colagem porque alguém perdeu um traço não ajuda ninguém.

Por que um nome e um UUID não são intercambiáveis

Um nome de usuário pode ser alterado e reutilizado; um UUID não. Então uma busca por nome de usuário responde "quem tem esse nome agora", e uma busca por UUID responde "esta conta específica, não importa como ela se chame hoje".

Para qualquer coisa que você esteja armazenando — uma whitelist, um placar, um datapack, uma cabeça — o UUID é o que continua correto. O nome de usuário é o que é conveniente de digitar.

Quatro animações, e são poses ao longo do tempo

O visualizador oferece parado, andando, correndo e voando. São animações, e não poses estáticas, o que importa na hora de avaliar uma skin: uma textura que fica bem parada pode parecer errada quando os braços balançam, porque as laterais do braço — as faces que você nunca vê numa prévia plana — entram em cena.

É esse o argumento para visualizar uma skin em movimento, em vez de apenas renderizar uma frente e uma costas.

Visualizador de skins →

Mais guias

Ver todos →