Guias / Servidores e desempenho
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á conectado
/whitelist on começa a aplicar a lista a partir daquele momento. Qualquer pessoa já conectada permanece conectada, mesmo que não esteja na lista. O comando que resolve essa lacuna é:
/whitelist reloadreload 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 e conectado. Servidores offline devem editarwhitelist.jsonmanualmente 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). Remover o banimento de um deles não limpa o outro — por isso um jogador “perdoado” às vezes ainda não consegue entrar. Quando os dois tipos de banimento estiverem ativos, use tanto /pardon quanto /pardon-ip.
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ível | Concede |
|---|---|
| 1 | Ignorar proteção de spawn |
| 2 | A maioria dos comandos de trapaça, blocos de comando |
| 3 | Gerenciamento de jogadores — kick, ban, op |
| 4 | Tudo, 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 comprometidos por uma conta invadida.
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 a partir do terminal do servidor. /whitelist list mostra apenas nomes, não UUIDs — leia whitelist.json quando precisar verificar a identidade.
Crie qualquer um desses com os argumentos na ordem correta no Construtor de Comandos de Administração de Servidor, que abrange ban, ban-ip, pardon, kick, op, deop e whitelist a partir de um único formulário.