Minecraft-Plugin SuperVanish

🔌 Über SuperVanish

SuperVanish ist ein Minecraft-Plugin für Bukkit/Spigot-Server, mit dem Server-Operatoren und Teammitglieder für andere Spieler vollständig unsichtbar werden können. Es soll einen nicht erkennbaren Vanish-Zustand bieten, der sich für Moderation und Tests eignet, und stellt gleichzeitig eine API bereit, über die andere Plugins mit dem Vanish-Zustand interagieren können.

🎯 Zweck

Der Hauptzweck des Plugins ist Moderation und administrative Überwachung: Vertrauenswürdige Teammitglieder können das Verhalten von Spielern beobachten, ohne für die meisten Spieler in der Spielerliste, in Beitritts-/Verlassensnachrichten oder in der sichtbaren Präsenz in der Welt aufzutauchen. Es richtet sich an Serverbesitzer, Administratoren und Plugin-Entwickler, die eine zuverlässige Vanish-Implementierung benötigen.

⚙️ Funktionen

• Blendet verschwindene Spieler vollständig vor anderen Spielern aus (Sichtbarkeit in der Welt).
• Blendet verschwindene Spieler in der Spielerliste (Tab) aus, mit konfigurierbarer Darstellung für Beobachter.
• Passt die gemeldete Anzahl der Online-Spieler/Serverliste an, wenn ProtocolLib verfügbar ist.
• Mehrstufiges Berechtigungsmodell, um genau festzulegen, wer wen sehen kann.
• Behält den Vanish-Zustand über Beitritte, Neustarts und Reloads hinweg bei.
• Optionale Integrationspunkte, die ProtocolLib für fortgeschrittene paketbasierte Funktionen erfordern.
• Optionale Empfehlung, OpenInv zu installieren, um das Verhalten von "silent chest" zu verbessern.
• Öffentliche VanishAPI für andere Plugins: Methoden zum Verstecken/Anzeigen von Spielern, Abfragen unsichtbarer Spieler und Lauschen auf PlayerHideEvent/PlayerShowEvent.

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die verdeckte Moderationstools benötigen.
• Server, die eine Vanish-API für andere Moderations- oder Utility-Plugins wollen.
• Administratoren, die konfigurierbare Sichtbarkeitsregeln und Kontrolle über die Tabliste benötigen.

🏗️ Beispielanwendungsfälle

• Ein Moderator wird unsichtbar, um einen Griefing-Bericht zu untersuchen, ohne Verdächtige zu alarmieren.
• Ein Plugin fragt die VanishAPI ab, um verschwundene Spieler von Gameplay-Mechaniken oder Berichten auszuschließen.
• Server-Operatoren verbergen ihre Präsenz während Live-Tests, um spielerexklusive Bedingungen zu simulieren.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR herunter und lege sie im plugins/-Verzeichnis deines Servers ab.
• Starte den Server neu und prüfe in den Konsolenlogs, ob SuperVanish geladen wurde.
• Wenn du ProtocolLib für erweiterte Funktionen verwendest, installiere ProtocolLib ebenfalls und starte neu.

📦 Abhängigkeiten

• ProtocolLib (optional): erforderlich für paketbasierte Funktionen wie das Anpassen der Spielerzahl und bestimmte Action-Bar-Funktionen.
• OpenInv (optionale Empfehlung): verbessert das Verhalten von silent chest beim Interagieren mit Inventaren, während man sich im Vanish befindet.

🧠 Technische Hinweise

• Plattform: als Bukkit/Spigot-Plugin implementiert und stellt eine Java-API für andere Plugins bereit.
• API: bietet VanishAPI mit Methoden zum Verstecken/Anzeigen von Spielern, zum Prüfen des Vanish-Status und zum Abrufen von Listen unsichtbarer Spieler; enthält PlayerHideEvent und PlayerShowEvent für eventgesteuerte Integrationen.
• Persistenz: kann über die API Listen aller unsichtbaren Spieler (online und offline) zurückgeben; das Abrufen aller unsichtbaren Spieler kann Datenbankzugriffe erfordern und sollte außerhalb des Hauptthreads mit Vorsicht verwendet werden.
• Lizenz: unter der MIT-Lizenz veröffentlicht, und der Quellcode ist im Repository des Projekts verfügbar.

🤝 Wann dieses Plugin nützlich ist

Wenn du eine Vanish-Implementierung brauchst, die sich mit anderen Plugins integriert und nuancierte Sichtbarkeitsregeln für die Moderation unterstützt, bietet SuperVanish ein API-gesteuertes, konfigurierbares Vanish mit optionalen ProtocolLib/OpenInv-Integrationen für ein verbessertes Verhalten.