UUID e Skin do Minecraft

Continuar na ferramenta

Mais páginas desta ferramenta

whitelist.json minecraft uuid

Gerar whitelist.json do Minecraft a partir de uma lista de nicks

Na aba Em lote, cole os nicks (um por linha), escolha a origem do UUID e o formato de saída, e baixe o arquivo. Nicks que não existem na Mojang são listados à parte, para você corrigir a grafia antes de usar o arquivo.

O formato dos arquivos e a escolha entre UUID online e offline

O whitelist.json do servidor Java é uma lista de objetos com dois campos: uuid, com hífens, e name. O ops.json tem os mesmos dois campos mais level, de 1 a 4, e bypassesPlayerLimit, verdadeiro ou falso. A ferramenta gera os dois com indentação de 2 espaços, como o próprio servidor grava. Para a whitelist funcionar, o servidor precisa de white-list=true no server.properties; com enforce-whitelist=true, ao recarregar a whitelist quem não está na lista é expulso, inclusive quem já estava online.
A origem do UUID depende do modo do servidor. Em online-mode=true use a origem Online: a ferramenta consulta a Mojang em lotes de 10 nicks (o máximo que a API em massa aceita), junta as respostas, mantém a ordem da lista e separa os nicks inexistentes. Em online-mode=false use a origem Offline: cada UUID é calculado localmente pelo MD5 de OfflinePlayer:nick, e não há consulta alguma. Misturar as duas coisas é o erro mais comum, e o resultado é uma whitelist que parece certa e deixa todo mundo de fora.
A lista aceita nicks separados por quebra de linha, vírgula, ponto e vírgula ou espaço, remove repetidos sem diferenciar maiúsculas e recusa nicks fora da regra antes de qualquer consulta. O limite é 100 nicks por vez; para listas maiores, faça em partes e junte os arquivos. Os UUIDs consultados ficam em cache por alguns minutos, e a Mojang aceita em torno de 200 requisições a cada 2 minutos por IP, então uma lista de 100 nicks consome 10 dessas requisições.
Depois de gerar, coloque o arquivo na pasta do servidor, substituindo o antigo, e rode /whitelist reload para o servidor reler a lista sem reiniciar. Os mesmos nicks também saem como CSV (nick, UUID com hífens e UUID sem hífens), útil para planilhas e bancos de dados, e como texto nick=UUID, uma linha por jogador. Conferir a lista de nicks não encontrados evita aquele jogador que digita a whitelist errada e passa meia hora tentando entrar.

Exemplos conferidos

Linha do whitelist.json (online)

Entrada: Notch
Saída esperada: {"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","name":"Notch"}

UUID oficial da Mojang, com hífens.

Linha do whitelist.json (offline)

Entrada: Notch
Saída esperada: {"uuid":"b50ad385-829d-3141-a216-7e7d7539ba7f","name":"Notch"}

UUID calculado do nick.

Linha do ops.json

Entrada: Notch, nível 4
Saída esperada: {"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","name":"Notch","level":4,"bypassesPlayerLimit":false}

Nível 4 é o mais alto.

Linha do CSV

Entrada: Notch
Saída esperada: Notch,069a79f4-44e9-4726-a5be-fca90e38aaf5,069a79f444e94726a5befca90e38aaf5

Cabeçalho: name,uuid,uuid_no_dashes.

Linha em texto

Entrada: Notch
Saída esperada: Notch=069a79f4-44e9-4726-a5be-fca90e38aaf5

Uma linha por jogador.

FAQ da ferramenta completa

Como descobrir o UUID de um jogador de Minecraft pelo nick?

Digite o nick na aba Consultar. A ferramenta pergunta à API da Mojang e mostra o UUID com hífens (069a79f4-44e9-4726-a5be-fca90e38aaf5 para Notch), sem hífens e no int array do NBT. O nick não diferencia maiúsculas de minúsculas na consulta, e o resultado traz a grafia oficial. O nick precisa existir hoje: nomes antigos que o jogador trocou não resolvem.

O UUID muda quando a pessoa troca de nick?

Qual é a diferença entre o UUID online e o UUID offline?

Como o UUID offline é calculado, e é igual ao do servidor Java?

O que é o formato [I;a,b,c,d] e quando usar?

Como dar a cabeça de um jogador com /give?

Como saber se a skin é clássica (Steve) ou slim (Alex)?

Posso baixar a skin e a capa de qualquer jogador?

Quantos nicks posso converter de uma vez?

Por que meu nick não aparece, ou aparece erro de limite?

Perguntas frequentes

Por que o nick está em "não encontrados" se o jogador existe?

Conferir a grafia costuma resolver: troca de l minúsculo por I maiúsculo, zero no lugar de O ou um espaço sobrando. Jogadores só do Bedrock também não têm perfil Java e não aparecem.

Preciso reiniciar o servidor depois de trocar o arquivo?

Não: /whitelist reload relê o whitelist.json. Já o ops.json costuma ser lido só na inicialização, então para a lista de operadores vale reiniciar ou usar /op para cada jogador.

O que significa o nível do ops.json?

É o nível de permissão do operador, de 1 a 4. O 4 libera tudo, incluindo parar o servidor. A ferramenta deixa escolher o nível; use o menor que resolve o caso do jogador.

Próximos passos

O formato dos arquivos e a escolha entre UUID online e offline

O whitelist.json do servidor Java é uma lista de objetos com dois campos: uuid, com hífens, e name. O ops.json tem os mesmos dois campos mais level, de 1 a 4, e bypassesPlayerLimit, verdadeiro ou falso. A ferramenta gera os dois com indentação de 2 espaços, como o próprio servidor grava. Para a whitelist funcionar, o servidor precisa de white-list=true no server.properties; com enforce-whitelist=true, ao recarregar a whitelist quem não está na lista é expulso, inclusive quem já estava online.

A origem do UUID depende do modo do servidor. Em online-mode=true use a origem Online: a ferramenta consulta a Mojang em lotes de 10 nicks (o máximo que a API em massa aceita), junta as respostas, mantém a ordem da lista e separa os nicks inexistentes. Em online-mode=false use a origem Offline: cada UUID é calculado localmente pelo MD5 de OfflinePlayer:nick, e não há consulta alguma. Misturar as duas coisas é o erro mais comum, e o resultado é uma whitelist que parece certa e deixa todo mundo de fora.

A lista aceita nicks separados por quebra de linha, vírgula, ponto e vírgula ou espaço, remove repetidos sem diferenciar maiúsculas e recusa nicks fora da regra antes de qualquer consulta. O limite é 100 nicks por vez; para listas maiores, faça em partes e junte os arquivos. Os UUIDs consultados ficam em cache por alguns minutos, e a Mojang aceita em torno de 200 requisições a cada 2 minutos por IP, então uma lista de 100 nicks consome 10 dessas requisições.

Depois de gerar, coloque o arquivo na pasta do servidor, substituindo o antigo, e rode /whitelist reload para o servidor reler a lista sem reiniciar. Os mesmos nicks também saem como CSV (nick, UUID com hífens e UUID sem hífens), útil para planilhas e bancos de dados, e como texto nick=UUID, uma linha por jogador. Conferir a lista de nicks não encontrados evita aquele jogador que digita a whitelist errada e passa meia hora tentando entrar.

Exemplos conferidos

Linha do whitelist.json (online)

Entrada: Notch
Saída esperada: {"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","name":"Notch"}

UUID oficial da Mojang, com hífens.

Linha do whitelist.json (offline)

Entrada: Notch
Saída esperada: {"uuid":"b50ad385-829d-3141-a216-7e7d7539ba7f","name":"Notch"}

UUID calculado do nick.

Linha do ops.json

Entrada: Notch, nível 4
Saída esperada: {"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","name":"Notch","level":4,"bypassesPlayerLimit":false}

Nível 4 é o mais alto.

Linha do CSV

Entrada: Notch
Saída esperada: Notch,069a79f4-44e9-4726-a5be-fca90e38aaf5,069a79f444e94726a5befca90e38aaf5

Cabeçalho: name,uuid,uuid_no_dashes.

Linha em texto

Entrada: Notch
Saída esperada: Notch=069a79f4-44e9-4726-a5be-fca90e38aaf5

Uma linha por jogador.

FAQ da ferramenta completa

Como descobrir o UUID de um jogador de Minecraft pelo nick?

O UUID muda quando a pessoa troca de nick?

Qual é a diferença entre o UUID online e o UUID offline?

Como o UUID offline é calculado, e é igual ao do servidor Java?

O que é o formato [I;a,b,c,d] e quando usar?

Como dar a cabeça de um jogador com /give?

Como saber se a skin é clássica (Steve) ou slim (Alex)?

Posso baixar a skin e a capa de qualquer jogador?

Quantos nicks posso converter de uma vez?

Por que meu nick não aparece, ou aparece erro de limite?

Perguntas frequentes

Por que o nick está em "não encontrados" se o jogador existe?

Conferir a grafia costuma resolver: troca de l minúsculo por I maiúsculo, zero no lugar de O ou um espaço sobrando. Jogadores só do Bedrock também não têm perfil Java e não aparecem.

Preciso reiniciar o servidor depois de trocar o arquivo?

Não: /whitelist reload relê o whitelist.json. Já o ops.json costuma ser lido só na inicialização, então para a lista de operadores vale reiniciar ou usar /op para cada jogador.

O que significa o nível do ops.json?

É o nível de permissão do operador, de 1 a 4. O 4 libera tudo, incluindo parar o servidor. A ferramenta deixa escolher o nível; use o menor que resolve o caso do jogador.