Guides / Server & Performance

Whitelist, ban e op: os comandos de servidor que se comportam de forma diferente do esperado

A whitelist não expulsa jogadores já online, /ban precisa de um motivo para ser útil, e o nível de op importa mais do que a lista de ops. Os detalhes que pegam os donos de servidor de surpresa.

Os comandos de administração parecem simples e, em sua maioria, são. As falhas surgem de três comportamentos que não são óbvios pela sintaxe.

A whitelist não remove quem já está dentro

/whitelist on começa a aplicar a lista a partir daquele momento. Qualquer um já conectado permanece conectado, mesmo que não esteja na lista. O comando que fecha essa lacuna é:

/whitelist reload

reload relê whitelist.json e expulsa os jogadores conectados que não estão nela. Ligar a whitelist e se afastar é o erro clássico.

Mais dois detalhes:

  • /whitelist add <name> resolve o nome usando a API da Mojang, então o servidor precisa estar no modo online (online-mode) e conectado. Servidores offline devem editar whitelist.json manualmente com o UUID correto.
  • Operadores ignoram a whitelist por padrão, e é por isso que sua própria conta nunca prova que a whitelist funciona. Teste com uma segunda conta.

/ban precisa de um motivo, e /ban-ip é uma lista diferente

/ban <player> [reason]
/ban-ip <address|player> [reason]

O motivo é opcional, e omiti-lo é um erro — é o que o Jogador banido vê, e é o que você, no futuro, lerá em /banlist tentando se lembrar do porquê. Sem um motivo, a entrada simplesmente diz "Banido por um operador".

/ban e /ban-ip escrevem em arquivos separados (banned-players.json, banned-ips.json). Perdoar um não limpa o outro, que é a razão usual pela qual um Jogador "perdoado" ainda não consegue se conectar. Use /pardon e /pardon-ip ambos.

Níveis de op, não apenas a lista de ops

/op concede nível 4 por padrão, que é acesso total, incluindo /stop. Os quatro níveis são reais e configuráveis em server.properties via op-permission-level:

NívelConcede
1Ignorar Proteção de spawn
2A maioria dos comandos de trapaça, blocos de comando
3Gerenciamento de Jogador — kick, ban, op
4Tudo, incluindo /stop

Moderadores que precisam de /kick e /ban querem o nível 3, não o 4. Distribuir o nível 4 para todos que ajudam a moderar é como servidores são apagados por uma conta comprometida.

function-permission-level é separado e controla quais funções de datapack podem ser executadas — deixá-lo em 2 enquanto o nível de op é 4 é uma fonte comum de "minha função não faz nada".

Os comandos de lista

/banlist players, /banlist ips e o simples /banlist todos existem e imprimem no console em vez do chat se executados do terminal do servidor. /whitelist list mostra apenas nomes, não UUIDs — leia whitelist.json quando precisar verificar a identidade.

Construa qualquer um desses com os argumentos na ordem correta no Server Admin Command Builder, que abrange ban, ban-ip, pardon, kick, op, deop e whitelist a partir de um único formulário.

Construtor de comandos de administração →

More guides

Browse all →

Procurando mais ferramentas de Minecraft?

Um conjunto de geradores, visualizadores e conversores que rodam no navegador — tudo grátis.