Plugin de Minecraft SuperVanish

🔌 Acerca de SuperVanish

SuperVanish es un plugin de Minecraft para servidores Bukkit/Spigot que permite que los operadores y el personal del servidor se vuelvan completamente invisibles para los demás jugadores. Su objetivo es ofrecer un estado de vanish indetectable, adecuado para moderación y pruebas, a la vez que expone una API para que otros plugins interactúen con el estado de vanish.

🎯 Propósito

El objetivo principal del plugin es la moderación y la supervisión administrativa: permitir que el personal de confianza observe el comportamiento de los jugadores sin aparecer en la lista de jugadores, en los mensajes de entrada/salida ni en la presencia dentro del mundo para la mayoría de los jugadores. Está pensado para propietarios de servidores, administradores y desarrolladores de plugins que necesitan una implementación de vanish fiable.

⚙️ Características

• Oculta por completo a los jugadores en vanish de los demás jugadores (visibilidad en el mundo).
• Oculta a los jugadores en vanish en la lista de jugadores (tab) con una apariencia configurable para los observadores.
• Ajusta el recuento de jugadores en línea/la lista del servidor informados cuando ProtocolLib está disponible.
• Modelo de permisos por capas para configurar con precisión quién puede ver a quién.
• Mantiene el estado de vanish entre entradas, reinicios y recargas.
• Puntos de integración opcionales que requieren ProtocolLib para funciones avanzadas basadas en paquetes.
• Recomendación opcional de instalar OpenInv para mejorar el comportamiento del "silent chest".
• VanishAPI pública para otros plugins: métodos para ocultar/mostrar jugadores, consultar jugadores invisibles y escuchar PlayerHideEvent/PlayerShowEvent.

🧩 Para quién es

• Servidores Survival y SMP que necesitan herramientas de moderación sigilosa.
• Servidores que quieren una API de vanish para otros plugins de moderación o utilidad.
• Administradores que necesitan reglas de visibilidad configurables y control de la tablist.

🏗️ Casos de uso de ejemplo

• Un moderador se vuelve invisible para investigar un reporte de griefing sin alertar a los sospechosos.
• Un plugin consulta VanishAPI para excluir a los jugadores en vanish de mecánicas de juego o reportes.
• Los operadores del servidor ocultan su presencia durante pruebas en vivo para simular condiciones solo con jugadores.

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin y colócalo en el directorio plugins/ de tu servidor.
• Reinicia el servidor y verifica en los registros de la consola que SuperVanish se haya cargado.
• Si usas ProtocolLib para funciones ampliadas, instala también ProtocolLib y reinicia.

📦 Dependencias

• ProtocolLib (opcional): necesario para funciones basadas en paquetes, como ajustar el recuento de jugadores y ciertas funciones de la barra de acción.
• OpenInv (recomendación opcional): mejora el comportamiento del "silent chest" al interactuar con inventarios mientras estás en vanish.

🧠 Notas técnicas

• Plataforma: implementado como un plugin Bukkit/Spigot y expone una API Java para otros plugins.
• API: proporciona VanishAPI con métodos para ocultar/mostrar jugadores, comprobar el estado de vanish y recuperar listas de jugadores invisibles; incluye PlayerHideEvent y PlayerShowEvent para integraciones orientadas a eventos.
• Persistencia: puede devolver listas de todos los jugadores invisibles (en línea y fuera de línea) mediante la API; recuperar todos los jugadores invisibles puede implicar acceso a la base de datos y debe usarse con cuidado fuera del hilo principal.
• Licencia: publicado bajo la licencia MIT y el código fuente está disponible en el repositorio del proyecto.

🤝 Cuándo es útil este plugin

Si necesitas una implementación de vanish que se integre con otros plugins y admita reglas de visibilidad matizadas para la moderación, SuperVanish ofrece un vanish configurable y orientado a API, con integraciones opcionales de ProtocolLib/OpenInv para un mejor comportamiento.