Plugin Minecraft SuperVanish

🔌 Sobre o SuperVanish

SuperVanish é um plugin do Minecraft para servidores Bukkit/Spigot que permite que operadores do servidor e membros da equipe fiquem completamente invisíveis para outros jogadores. Ele tem como objetivo oferecer um estado de vanish indetectável, adequado para moderação e testes, ao mesmo tempo em que expõe uma API para outros plugins interagirem com o estado de vanish.

🎯 Objetivo

O objetivo principal do plugin é moderação e monitoramento administrativo: permitir que a equipe confiável observe o comportamento dos jogadores sem aparecer na lista de jogadores, nas mensagens de entrada/saída ou na presença no mundo para a maioria dos jogadores. Ele é destinado a donos de servidores, administradores e desenvolvedores de plugins que precisam de uma implementação de vanish confiável.

⚙️ Recursos

• Esconde completamente os jogadores em vanish dos outros jogadores (visibilidade no mundo).
• Oculta os jogadores em vanish na lista de jogadores (TAB) com aparência configurável para observadores.
• Ajusta a contagem de jogadores online/lista do servidor informada quando o ProtocolLib está disponível.
• Modelo de permissões em camadas para configurar com precisão quem pode ver quem.
• Mantém o estado de vanish entre entradas, reinícios e recarregamentos.
• Pontos de integração opcionais que exigem ProtocolLib para recursos avançados baseados em pacotes.
• Recomendação opcional de instalar OpenInv para melhorar o comportamento do "silent chest".
• VanishAPI pública para outros plugins: métodos para esconder/mostrar jogadores, consultar jogadores invisíveis e escutar PlayerHideEvent/PlayerShowEvent.

🧩 Para quem é

• Servidores Survival e SMP que precisam de ferramentas de moderação furtiva.
• Servidores que querem uma API de vanish para outros plugins de moderação ou utilidade.
• Administradores que precisam de regras de visibilidade configuráveis e controle da tablist.

🏗️ Casos de uso de exemplo

• Um moderador fica invisível para investigar uma denúncia de griefing sem alertar os suspeitos.
• Um plugin consulta a VanishAPI para excluir jogadores em vanish de mecânicas de jogo ou relatórios.
• Operadores do servidor escondem sua presença durante testes ao vivo para simular condições apenas com jogadores.

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin e coloque-o no diretório plugins/ do seu servidor.
• Reinicie o servidor e verifique nos logs do console se o SuperVanish foi carregado.
• Se estiver usando ProtocolLib para recursos estendidos, instale o ProtocolLib também e reinicie.

📦 Dependências

• ProtocolLib (opcional): necessário para recursos baseados em pacotes, como ajustar a contagem de jogadores e certos recursos da action bar.
• OpenInv (recomendação opcional): melhora o comportamento do "silent chest" ao interagir com inventários enquanto estiver em vanish.

🧠 Notas técnicas

• Plataforma: implementado como um plugin Bukkit/Spigot e expõe uma API Java para outros plugins.
• API: fornece a VanishAPI com métodos para esconder/mostrar jogadores, verificar o status de vanish e recuperar listas de jogadores invisíveis; inclui PlayerHideEvent e PlayerShowEvent para integrações orientadas a eventos.
• Persistência: pode retornar listas de todos os jogadores invisíveis (online e offline) via API; recuperar todos os jogadores invisíveis pode envolver acesso ao banco de dados e deve ser usado com cuidado fora da thread principal.
• Licença: lançado sob a licença MIT e o código-fonte está disponível no repositório do projeto.

🤝 Quando este plugin é útil

Se você precisa de uma implementação de vanish que se integre com outros plugins e ofereça regras de visibilidade detalhadas para moderação, o SuperVanish fornece um vanish configurável, orientado por API, com integrações opcionais com ProtocolLib/OpenInv para melhor comportamento.