Configurar a whitelist do servidor Minecraft - permitir só amigos

Com uma whitelist do Minecraft, limitas o teu servidor a jogadores expressamente autorizados. Isto faz sentido para mundos survival privados, projetos de construção, eventos ou comunidades em que queres manter o controlo dos acessos. Três pontos são decisivos: white-list=true, nomes de jogadores bem mantidos e enforce-whitelist=true, para que as alterações tenham efeito de forma fiável.

Requisitos

Precisas de acesso à consola do servidor, permissões de OP no jogo ou acesso ao ficheiro server.properties. Além disso, deves conhecer os nomes exatos de Minecraft dos jogadores. Em contas Java, normalmente basta o nome de jogador. Se jogadores Bedrock entrarem através do Geyser, o nome pode aparecer com um prefixo, dependendo da configuração do Geyser; no exemplo de base é usado um ponto.

Se ainda estás a configurar o servidor do zero, o guia complementar Alugar e configurar um servidor Minecraft - Guia completo 2026 ajuda-te. Para outras configurações cooperativas com uma lógica de acesso semelhante, também encontras o Alugar e configurar um servidor Valheim - Guia coop 2026.

Configurar a whitelist do Minecraft

O que é a whitelist?

A whitelist é um controlo de acesso para o teu servidor. Só jogadores na lista podem entrar. Ela não substitui a moderação, mas impede que contas desconhecidas entrem simplesmente através do endereço do servidor. Para alojamento multi-game pago, isto é especialmente prático, porque consegues separar melhor o acesso ao servidor, casos de suporte e processos operacionais: quem não está na lista não entra.

A Microsoft documenta o comando Bedrock correspondente como /allowlist; aí, /whitelist é indicado como alias, e são descritas as ações add, remove, list, off, on e reload: Microsoft Learn sobre allowlist/whitelist. Para servidores Java, as entradas de server.properties e os comandos /whitelist mostrados abaixo continuam a ser a base prática.

Ativar a whitelist

No server.properties:

white-list=true
enforce-whitelist=true

Já que estás no server.properties: a linha motd define a entrada do teu servidor na lista de servidores; podes personalizá-la com cores usando o nosso gerador de MOTD gratuito.

Ou por comando dentro do jogo:

/whitelist on

Se editares o ficheiro diretamente, para antes o servidor ou reinicia-o depois. As alterações por comandos são mais cómodas durante o funcionamento, porque não tens de ir sempre ao ficheiro.

Adicionar jogadores

/whitelist add <Spielername>

Para jogadores Bedrock (através do Geyser):

/whitelist add .<BedRockName>

Tem atenção à ortografia. Se um jogador não conseguir entrar apesar de o teres adicionado, compara o nome com a indicação na tentativa de login ou nos logs do servidor. Em configurações com Geyser, é especialmente importante saber se é usado um prefixo e como as maiúsculas/minúsculas são tratadas.

Gerir a whitelist

Usa /whitelist list após cada alteração maior. Assim detetas imediatamente erros de digitação ou nomes duplicados por engano. Se removeres um jogador, enforce-whitelist=true é importante para que a exclusão não se torne relevante apenas na próxima tentativa de ligação.

whitelist.json

A whitelist é guardada em whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "NomeJogador"
  }
]

Edita este ficheiro só se souberes o que estás a fazer. Para a operação normal, os comandos são mais seguros, porque o servidor gere nomes e UUIDs corretamente. Se alterares o ficheiro manualmente, usa depois /whitelist reload ou reinicia o servidor.

Verificar o resultado

Verifica primeiro com /whitelist list se todos os jogadores pretendidos estão incluídos. Depois, um jogador registado deve conseguir entrar. Uma conta não registada deve ser recusada. Confere também a consola do servidor: aí vês se a tentativa de entrada falha por causa da whitelist, de um nome incorreto ou de outro problema.

Para projetos privados, uma rotina curta faz sentido: adicionar jogador, testar entrada, mostrar lista, documentar alteração. Especialmente com vários admins, isto evita que dúvidas de suporte fiquem pouco claras mais tarde.

Resolução de problemas

O jogador está na lista, mas não consegue entrar

Verifica o nome exato, o modo de jogo e possíveis prefixos no Geyser. Em caso de dúvida, remove a entrada com /whitelist remove <name> e adiciona-a novamente em seguida.

Jogadores removidos continuam online

Define enforce-whitelist=true e recarrega a lista com /whitelist reload. Sem esta definição, jogadores removidos podem continuar ligados até se desconectarem, dependendo do estado do servidor.

As alterações no ficheiro não têm efeito

Se alteraste manualmente server.properties ou whitelist.json, recarrega a whitelist ou reinicia o servidor de forma controlada. Verifica também se editaste mesmo o ficheiro da instância de servidor ativa.

Confundir OPs e whitelist

Permissões de operador são permissões de administração, não uma lista de acesso limpa. Mantém poucos OPs e gere a whitelist separadamente. Assim fica claro quem pode administrar e quem só pode jogar.

Dicas

• Enforce Whitelist: Ativa enforce-whitelist=true para que jogadores sejam expulsos quando forem removidos da lista
• Ops: Operadores (OPs) também podem entrar sem whitelist se enforce-whitelist estiver desativado
• Automatização: Usa plugins como EasyWhitelist para gestão baseada na web

Verificação, limites e caminho seguro de retorno

O guia "Configurar a whitelist do servidor Minecraft - permitir só amigos" aplica-se ao tipo de servidor descrito no artigo e ao estado de versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar após atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.

Antes de alterações ao mundo, save, configuração ou extensões, cria um backup dos ficheiros afetados. Depois altera apenas um passo coerente de cada vez e testa-o com a mesma versão de cliente e servidor com que queres jogar mais tarde.

Um teste individual bem-sucedido não é garantia de desempenho nem de disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, rota de rede e carga simultânea podem alterar o resultado. Documenta versão, alteração e resultado do teste para conseguires entender desvios futuros.

FAQ

Preciso de reiniciar após cada alteração?

Não necessariamente. Se usares comandos como /whitelist add, /whitelist remove ou /whitelist reload, podes gerir a lista com o servidor em funcionamento. Após alterações manuais em ficheiros, um reload ou reinício faz sentido.

A whitelist é melhor do que uma palavra-passe?

Para Minecraft, a whitelist é o método mais habitual, porque autoriza contas concretas. Uma palavra-passe não protege contra dados de acesso partilhados, enquanto uma whitelist fica associada a nomes de jogadores ou contas.

Devo ativar sempre enforce-whitelist=true?

Para servidores privados, normalmente faz sentido. A definição garante que jogadores removidos não continuam online após um reload, mesmo já não estando na lista.

A whitelist funciona com mods e plugins?

Sim, a whitelist básica é uma função do servidor. Plugins podem oferecer gestão adicional, mas devem ser escolhidos conscientemente e mantidos atualizados.

O que faço com jogadores Bedrock através do Geyser?

Verifica como a tua configuração do Geyser mapeia nomes Bedrock. No exemplo é usado .<BedRockName>. Se a entrada falhar, confirma o nome realmente apresentado na consola ou nos logs.