CommandWhitelist: controle total dos comandos

Já administrou um servidor Minecraft em que os jogadores descobriram comandos que você preferia ocultar? CommandWhitelist resolve esse problema. Ele permite que os administradores controlem exatamente quais comandos os jogadores podem usar e ver, incluindo mensagens personalizadas de "comando desconhecido". Uma ideia simples. Um impacto enorme.

O que este plugin faz

CommandWhitelist é um plugin para servidores Minecraft que funciona como um guardião dos comandos. Em vez de todos os comandos ficarem visíveis para todos os jogadores, você define quais deles podem ou não ser usados. É possível bloquear completamente a execução, ocultar comandos do preenchimento automático com Tab ou controlar subcomandos específicos. O plugin funciona em servidores baseados em Bukkit (Spigot, Paper, Purpur e outros), proxies Waterfall e Velocity, o que o torna flexível para praticamente qualquer configuração de servidor.

A ideia central é simples, mas poderosa: não deixe os jogadores saberem que certos comandos existem se eles não deveriam usá-los. Se não conseguirem completar algo como "op" com Tab, será menos provável que tentem usá-lo. Se o comando "plugins" não aparecer nas sugestões, eles não poderão bisbilhotar a configuração do servidor nem descobrir os mods instalados. É segurança por obscuridade, mas, para administradores de servidores, essa discrição traz uma tranquilidade real.

Por que administradores de servidores usam este plugin

Primeiro cenário: você administra um servidor vanilla de sobrevivência com alguns comandos úteis instalados exclusivamente para administradores. Você não quer que jogadores comuns descubram `/give`, `/gamemode` ou `/tp`. CommandWhitelist mantém essas ferramentas perigosas invisíveis.

Segundo cenário: você tem um servidor com mods e mais de 50 comandos de plugins, mas quer que os jogadores vejam apenas aqueles que realmente podem usar. Em vez de sobrecarregar novos jogadores com `/admin`, `/debug`, `/dev` e outros quinze comandos aos quais eles não têm acesso, você mostra somente os comandos destinados a eles. Simples. Profissional.

Também existem os servidores focados em imersão. Administra uma comunidade de interpretação? Oculte comandos que tiram os jogadores do personagem. Está criando um servidor de desafio hardcore? Oculte comandos que facilitam a sobrevivência. Está montando um servidor de minijogos? Mostre apenas os comandos relevantes para cada jogo. Se você também estiver consultando a lista de servidores Minecraft para ganhar visibilidade, vai querer oferecer uma experiência bem-acabada, e CommandWhitelist ajuda nisso.

Não ignore as possibilidades de personalização da marca. Em vez da mensagem padrão "Unknown command. Type '/help' for help", CommandWhitelist permite personalizar a resposta. Adicione o nome do servidor, encaminhe os jogadores ao seu Discord e faça com que sintam que estão em um servidor autêntico e cuidadosamente planejado, não em uma instância genérica do Spigot.

Instalação e configuração

Colocar o CommandWhitelist em funcionamento leva dois minutos. Baixe o JAR mais recente no GitHub, coloque-o na pasta de plugins e reinicie:

cd /path/to/server/plugins
wget https://github.com/YouHaveTrouble/CommandWhitelist/releases/download/v2.12.0/CommandWhitelist-2.12.0.jar
# Restart your server

Na primeira inicialização, CommandWhitelist gera automaticamente um arquivo de configuração. Por padrão, nada é bloqueado, você precisa definir explicitamente o que deseja ocultar. A configuração usa YAML e é fácil de entender assim que você abre o arquivo.

Se você também gerencia a lista de jogadores permitidos no servidor, a ferramenta Criador de whitelist do Minecraft funciona muito bem com CommandWhitelist para cuidar separadamente da whitelist tradicional de nomes de usuário.

Principais recursos que resolvem problemas reais

Ocultar o preenchimento automático com Tab é o recurso de maior destaque. Quando os jogadores pressionam Tab depois de digitar `/`, CommandWhitelist controla quais sugestões aparecem. É algo discreto, mas resolve dois problemas: impede que os jogadores descubram comandos que não deveriam usar e elimina a confusão causada por comandos que não funcionam.

O controle de subcomandos diferencia este plugin dos bloqueadores de comandos mais básicos. A maioria dos plugins funciona no nível do comando: você permite `/say` por completo ou o bloqueia. CommandWhitelist vai além. É possível bloquear `/say message`, mas permitir `/say`. Para a maioria dos jogadores, você pode bloquear `/give player_item_amount` enquanto permite outros subcomandos de `/give`. Isso é importante quando existem estruturas complexas de permissões com subcomandos perigosos.

Mensagens personalizadas de "comando inexistente" substituem o texto de erro vanilla por algo adequado ao seu servidor. Em vez do erro padrão, você pode exibir algo como: "Esse comando não está disponível neste servidor" ou "Tem alguma dúvida? Consulte a documentação do servidor ou fale com um membro da equipe." É um pequeno detalhe que faz seu servidor parecer mais bem planejado.

A integração com permissões já vem incluída. Se um jogador não tiver permissão para usar um comando, CommandWhitelist o ocultará automaticamente do preenchimento com Tab. Combinado a um plugin de permissões como LuckPerms, isso cria uma experiência coesa em que os jogadores veem apenas os comandos que podem usar.

Detalhes importantes e armadilhas comuns

O principal detalhe: CommandWhitelist usa bloqueio opcional. Nada fica oculto até que você adicione explicitamente o item à configuração. Se espera que tudo venha oculto por padrão e apenas certos comandos sejam permitidos, você ficará decepcionado. É necessário configurar ativamente o que será bloqueado.

Bloquear o preenchimento com Tab não impede a execução do comando por outros meios. Se um jogador já conhece um comando `/give`, ainda poderá digitá-lo diretamente. CommandWhitelist pode bloquear a execução, mas, para manter o comando completamente oculto, você precisa impedir tanto o preenchimento com Tab quanto a execução. Planeje a configuração de acordo com o seu caso de uso.

A compatibilidade é sólida desde o Minecraft 1.13, cobrindo praticamente todos os servidores ativos. A versão mais recente (v2.12.0) foi compilada com Java 21 e dependências adventure atualizadas. Se o seu servidor usa a versão 1.12 ou anterior, CommandWhitelist não poderá ajudar, embora, nesse caso, você provavelmente tenha problemas maiores.

Uma limitação importante: CommandWhitelist funciona em proxies Waterfall, mas não oferece suporte ao BungeeCord. Se você usa BungeeCord, precisará configurar CommandWhitelist individualmente em cada servidor de backend, em vez de fazer isso de forma centralizada no proxy. Usuários do Waterfall têm a conveniência de uma configuração central.

Personalizando a apresentação do seu servidor

CommandWhitelist combina bem com outras iniciativas de personalização do servidor. Se você gerencia comandos, já está pensando na experiência dos jogadores. Essa mesma preocupação vale para permitir que eles explorem skins do Minecraft na sua comunidade, configurar pontos de surgimento personalizados e criar uma identidade distinta para o servidor. Esses pequenos detalhes se somam e fazem o servidor parecer profissional, em vez de montado às pressas.

Alternativas que vale a pena conhecer

PermissionsEx pode cuidar de parte do bloqueio de comandos, caso você já o utilize para gerenciar permissões. Ele é menos especializado do que CommandWhitelist, mas pode atender às suas necessidades. LiteBans inclui o recurso de ocultar comandos, porém é principalmente um sistema de punições, sendo mais indicado para quem precisa de gerenciamento completo de banimentos do que apenas de controle de comandos.