Minecraft plugin SuperVanish

🔌 Over SuperVanish

SuperVanish is een Minecraft-plugin voor Bukkit/Spigot-servers waarmee serveroperators en staff volledig onzichtbaar kunnen worden voor andere spelers. Het doel is om een onopvallende vanish-status te bieden die geschikt is voor moderatie en testen, terwijl het ook een API aanbiedt waarmee andere plugins met de vanish-status kunnen werken.

🎯 Doel

Het belangrijkste doel van de plugin is moderatie en administratieve monitoring: vertrouwde staff kunnen spelergedrag observeren zonder in de playerlist, join/leave-berichten of in-world aanwezigheid voor de meeste spelers te verschijnen. Hij is bedoeld voor servereigenaren, administrators en pluginontwikkelaars die een betrouwbare vanish-implementatie nodig hebben.

⚙️ Functies

• Verbergt vanished spelers volledig voor andere spelers (zichtbaarheid in de wereld).
• Verbergt vanished spelers in de player list (tab) met een configureerbare weergave voor waarnemers.
• Past het gerapporteerde aantal online spelers/server list aan wanneer ProtocolLib beschikbaar is.
• Gelaagd permissiemodel om precies te bepalen wie wie kan zien.
• Behoudt de vanish-status bij joins, herstarts en reloads.
• Optionele integratiepunten die ProtocolLib vereisen voor geavanceerde packet-gebaseerde functies.
• Optionele aanbeveling om OpenInv te installeren voor beter "silent chest"-gedrag.
• Openbare VanishAPI voor andere plugins: methoden om spelers te verbergen/tonen, onzichtbare spelers op te vragen en te luisteren naar PlayerHideEvent/PlayerShowEvent.

🧩 Voor wie is dit

• Survival- en SMP-servers die stealth-moderatietools nodig hebben.
• Servers die een vanish API willen voor andere moderatie- of utility-plugins.
• Administrators die configureerbare zichtbaarheid en controle over de tablist nodig hebben.

🏗️ Voorbeeldgebruik

• Een moderator wordt onzichtbaar om een grief-melding te onderzoeken zonder verdachten te waarschuwen.
• Een plugin vraagt VanishAPI op om vanished spelers uit gameplaymechanieken of rapporten uit te sluiten.
• Serveroperators verbergen hun aanwezigheid tijdens live tests om alleen-speleromstandigheden te simuleren.

⚙️ Installatie

📥 Setup

• Download de officiële plugin-JAR en plaats deze in de plugins/-map van je server.
• Herstart de server en controleer de consolelogs om te zien of SuperVanish correct is geladen.
• Als je ProtocolLib gebruikt voor uitgebreide functies, installeer ProtocolLib dan ook en herstart.

📦 Afhankelijkheden

• ProtocolLib (optioneel): vereist voor packet-gebaseerde functies zoals het aanpassen van het aantal spelers en bepaalde action-bar-functies.
• OpenInv (optionele aanbeveling): verbetert het silent chest-gedrag bij interactie met inventarissen terwijl je vanished bent.

🧠 Technische notities

• Platform: geïmplementeerd als een Bukkit/Spigot-plugin en biedt een Java API voor andere plugins.
• API: biedt VanishAPI met methoden om spelers te verbergen/tonen, de vanish-status te controleren en lijsten van onzichtbare spelers op te halen; bevat PlayerHideEvent en PlayerShowEvent voor event-gedreven integraties.
• Persistentie: kan via de API lijsten van alle onzichtbare spelers teruggeven (online en offline); het ophalen van alle onzichtbare spelers kan database-toegang vereisen en moet voorzichtig worden gebruikt buiten de main thread.
• Licentie: uitgebracht onder de MIT-licentie en de broncode is beschikbaar in de repository van het project.

🤝 Wanneer deze plugin nuttig is

Als je een vanish-implementatie nodig hebt die integreert met andere plugins en gedetailleerde zichtbaarheidregels voor moderatie ondersteunt, biedt SuperVanish een API-gedreven, configureerbare vanish met optionele ProtocolLib/OpenInv-integraties voor beter gedrag.