Skip to content
Pular para o conteúdo
Voltar ao Blog
CommandWhitelist: Controle Completo de Comandos

CommandWhitelist: Controle Completo de Comandos

Alexandru Maftei
Alexandru Maftei
@ice
Atualizado
21 visualizações
TL;DR:CommandWhitelist é um plugin de servidor Minecraft que oferece aos administradores controle preciso sobre quais comandos os jogadores podem usar e ver. Perfeito para servidores vanilla, redes modificadas e comunidades de role-play que precisam esconder comandos perigosos ou que quebram a imersão.
GitHub · Projeto da comunidade Minecraft

CommandWhitelist (YouHaveTrouble/CommandWhitelist)

Você decide quais comandos os jogadores podem usar ou completar com tab no seu servidor!

Estrele no GitHub ↗
⭐ 261 estrelas💻 Java📄 GPL-2.0

Já dirigiu um servidor Minecraft onde os jogadores descobriram comandos que você gostaria de esconder? CommandWhitelist resolve isso. Permite que administradores do servidor controlem exatamente quais comandos os jogadores podem usar e ver, completo com mensagens de "comando desconhecido" personalizadas. Ideia simples. Impacto poderoso.

O que Este Plugin Faz

CommandWhitelist é um plugin de servidor Minecraft que atua como guardião de comandos. Em vez de cada comando ser visível para cada jogador, você define o que eles podem e não podem usar. Você pode bloquear a execução de comando inteiramente, esconder comandos da conclusão de abas ou direcionar subcomandos específicos. O plugin funciona em servidores baseados em Bukkit (Spigot, Paper, Purpur e outros), proxies Waterfall e Velocity, tornando-o flexível para praticamente qualquer configuração de servidor.

A ideia central é simples mas poderosa - não deixe os jogadores saberem que comandos existem se não forem usá-los. Se seus jogadores não conseguem completar com tab algo como "op", é menos provável que tentem usá-lo. Se o comando "plugins" não aparecer nas sugestões, eles não vão bisbilhotar a configuração do seu servidor ou descobrir seus mods instalados. É segurança por obscuridade, mas para administradores de servidor, essa obscuridade compra real tranquilidade.


Por que Administradores de Servidor Usam Isso

Cenário um - você está gerenciando um servidor vanilla survival com alguns comandos de qualidade de vida apenas para admins instalados. Você não quer que jogadores regulares descubram `/give`, `/gamemode` ou `/tp`. CommandWhitelist mantém essas ferramentas perigosas invisíveis.

Cenário dois - você tem um servidor modificado com mais de 50 comandos de plugin e só quer que os jogadores vejam os que realmente podem usar. Em vez de sobrecarregar novos jogadores com `/admin`, `/debug`, `/dev` e quinze outros comandos que não podem tocar, você mostra apenas os comandos voltados para o jogador. Limpo. Profissional.

Depois há servidores focados em imersão. Gerenciando uma comunidade de role-play? Esconda comandos que quebram o personagem. Construindo um servidor de desafio hardcore? Esconda comandos que facilitam a sobrevivência. Criando um servidor de mini-games? Mostre apenas os comandos relevantes para cada jogo. Se você também está verificando a Lista de Servidores Minecraft para ser descoberto, você vai querer que seu servidor apresente uma experiência polida, e CommandWhitelist ajuda com isso.

Não ignore o ângulo da marca. Em vez da mensagem padrão "Comando desconhecido. Digite '/help' para ajuda", CommandWhitelist permite que você customize essa resposta. Adicione o nome do seu servidor, direcione jogadores para seu Discord, faça-os sentir que estão em um servidor real e intencional, não em uma instância genérica do Spigot.


Instalação e Configuração

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

bash
cd /path/to/server/plugins
wget https://github.com/YouHaveTrouble/CommandWhitelist/releases/download/v2.12.0/CommandWhitelist-2.12.0.jar
# Reinicie seu servidor

Na primeira inicialização, CommandWhitelist gera um arquivo de configuração automaticamente. O comportamento padrão não bloqueia nada - você precisa definir explicitamente o que deseja esconder. A configuração é baseada em YAML e direta uma vez que você abre o arquivo.

Se você também gerencia a whitelist de jogadores, a ferramenta Criador de Whitelist Minecraft funciona perfeitamente com CommandWhitelist para lidar com a whitelist tradicional de forma separada.


Recursos Principais Que Resolvem Problemas Reais

Esconder a conclusão de abas é o recurso destaque. Quando os jogadores pressionam tab depois de digitar `/`, CommandWhitelist controla quais sugestões aparecem. É sutil mas resolve dois problemas - prevenir que os jogadores descubram comandos que não deveriam usar, e eliminar confusão de ver comandos que não funcionam.

O direcionamento de subcomandos separa este plugin dos bloqueadores de comando unidimensionais. A maioria dos plugins funciona no nível de comando - você permite `/say` inteiramente ou o bloqueia. CommandWhitelist vai mais fundo. Você pode bloquear `/say message` mas permitir `/say`. Você também pode bloquear `/give player_item_amount` enquanto permite outros subcomandos `/give`. Isso importa quando você tem estruturas de permissão complexas com subcomandos perigosos.

Mensagens customizadas de "comando não encontrado" substituem o texto de erro vanilla com algo que se adequa ao seu servidor. Em vez do erro padrão, você obtém algo como: "Este comando não está disponível neste servidor" ou "Dúvidas? Verifique a documentação do seu servidor ou pergunte a um membro da equipe." É um pequeno toque que faz seu servidor parecer intencional.

A integração de permissões é incorporada. Se um jogador não tem permissão para usar um comando, CommandWhitelist o esconde da conclusão de abas automaticamente. Combinado com um plugin de permissões como LuckPerms, isso cria uma experiência coesa onde os jogadores veem apenas comandos que podem usar.


Pegadinhas e Armadilhas Comuns

A maior pegadinha - CommandWhitelist usa bloqueio de opt-in. Nada é escondido até você explicitamente adicionar ao config. Se você espera que tudo seja escondido por padrão e apenas certos comandos permitidos, você será desapontado. Você precisa ativamente configurar o que é bloqueado.

Bloquear a conclusão de abas não impede a execução de comando por outros meios. Se um jogador já conhece um comando `/give`, ele ainda pode digitá-lo diretamente. CommandWhitelist pode bloquear a execução, mas para segredo completo, você precisa impedir tanto conclusão de abas QUANTO execução. Planeje de acordo com seu caso de uso.

A compatibilidade funciona solidamente desde Minecraft 1.13, que cobre praticamente cada servidor ativo. A versão mais recente (v2.12.0) é compilada contra Java 21 com dependências Adventure atualizadas. Se seu servidor funciona em 1.12 ou anterior, CommandWhitelist não ajudará - embora nesse ponto você tenha problemas maiores.

Uma limitação crítica - CommandWhitelist funciona em proxies Waterfall mas explicitamente não suporta BungeeCord. Se você está executando BungeeCord, você precisará configurar CommandWhitelist em cada servidor backend individualmente em vez de centralmente no proxy. Usuários de Waterfall obtêm a conveniência da configuração central.


Customizando a Apresentação do Seu Servidor

CommandWhitelist funciona bem com outros esforços de customização do servidor. Você já está pensando na experiência do jogador se está gerenciando comandos. Essa mesma mentalidade se aplica a deixar jogadores procurar Skins Minecraft em sua comunidade, configurar spawns customizados e criar uma identidade de servidor distintiva. Esses pequenos toques se somam em um servidor que parece profissional em vez de improvisado.


Alternativas Que Vale a Pena Conhecer

PermissionsEx, se você já está executando para permissões, pode lidar com algum bloqueio de comando. É menos especializado que CommandWhitelist mas pode satisfazer suas necessidades. LiteBans tem ocultação de comando incorporada, mas é principalmente um sistema de punição - melhor se você precisa de gestão completa de banimento do que controle puro de comando.

Sobre o autor
Alexandru Maftei
Alexandru MafteiRedator-chefe

Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.

Comentários

Nenhum comentário ainda. Seja o primeiro a compartilhar sua opinião!

We use cookies to improve your experience. By continuing to use this site, you agree to our use of cookies. Read our Privacy Policy