Plugin Minecraft SuperVanish

🔌 À propos de SuperVanish

SuperVanish est un plugin Minecraft pour les serveurs Bukkit/Spigot qui permet aux opérateurs et au staff du serveur de devenir complètement invisibles pour les autres joueurs. Il vise à fournir un état de vanish indétectable, adapté à la modération et aux tests, tout en exposant une API pour que d'autres plugins interagissent avec l'état de vanish.

🎯 Objectif

L'objectif principal du plugin est la modération et la surveillance administrative : permettre au staff de confiance d'observer le comportement des joueurs sans apparaître dans la liste des joueurs, dans les messages d'arrivée/de départ, ni dans la présence en jeu pour la plupart des joueurs. Il est destiné aux propriétaires de serveurs, aux administrateurs et aux développeurs de plugins qui ont besoin d'une implémentation de vanish fiable.

⚙️ Fonctionnalités

• Masque totalement les joueurs en vanish des autres joueurs (visibilité en jeu).
• Masque les joueurs en vanish dans la liste des joueurs (tab) avec une apparence configurable pour les observateurs.
• Ajuste le nombre de joueurs en ligne/la liste du serveur signalés lorsque ProtocolLib est disponible.
• Modèle d'autorisations en couches pour configurer précisément qui peut voir qui.
• Conserve l'état de vanish entre les connexions, les redémarrages et les rechargements.
• Points d'intégration optionnels nécessitant ProtocolLib pour des fonctionnalités avancées basées sur les paquets.
• Recommandation facultative d'installer OpenInv pour améliorer le comportement du "silent chest".
• VanishAPI publique pour les autres plugins : méthodes pour masquer/afficher des joueurs, interroger les joueurs invisibles et écouter PlayerHideEvent/PlayerShowEvent.

🧩 Pour qui c'est fait

• Serveurs Survival et SMP qui ont besoin d'outils de modération furtive.
• Serveurs qui veulent une API de vanish pour d'autres plugins de modération ou d'utilité.
• Administrateurs qui ont besoin de règles de visibilité configurables et d'un contrôle de la tablist.

🏗️ Exemples d'utilisation

• Un modérateur devient invisible pour enquêter sur un signalement de grief sans alerter les suspects.
• Un plugin interroge VanishAPI pour exclure les joueurs en vanish des mécaniques de jeu ou des rapports.
• Les opérateurs du serveur cachent leur présence pendant des tests en direct pour simuler des conditions réservées aux joueurs.

⚙️ Installation

📥 Configuration

• Téléchargez le JAR officiel du plugin et placez-le dans le dossier plugins/ de votre serveur.
• Redémarrez le serveur et vérifiez dans les logs de la console que SuperVanish a bien été chargé.
• Si vous utilisez ProtocolLib pour des fonctionnalités étendues, installez aussi ProtocolLib puis redémarrez.

📦 Dépendances

• ProtocolLib (optionnel) : requis pour les fonctionnalités basées sur les paquets, comme l'ajustement du nombre de joueurs et certaines fonctions de la barre d'action.
• OpenInv (recommandation facultative) : améliore le comportement du "silent chest" lors de l'interaction avec des inventaires pendant le vanish.

🧠 Notes techniques

• Plateforme : implémenté comme un plugin Bukkit/Spigot et expose une API Java pour les autres plugins.
• API : fournit VanishAPI avec des méthodes pour masquer/afficher des joueurs, vérifier l'état de vanish et récupérer des listes de joueurs invisibles ; inclut PlayerHideEvent et PlayerShowEvent pour des intégrations pilotées par événements.
• Persistance : peut renvoyer des listes de tous les joueurs invisibles (en ligne et hors ligne) via l'API ; récupérer tous les joueurs invisibles peut impliquer un accès à la base de données et doit être utilisé avec précaution hors du thread principal.
• Licence : publié sous licence MIT et le code source est disponible dans le dépôt du projet.

🤝 Quand ce plugin est utile

Si vous avez besoin d'une implémentation de vanish qui s'intègre avec d'autres plugins et prend en charge des règles de visibilité nuancées pour la modération, SuperVanish propose un vanish configurable piloté par API, avec des intégrations optionnelles à ProtocolLib/OpenInv pour un meilleur comportement.