Minecraft-plugin SuperVanish

🔌 Om SuperVanish

SuperVanish er et Minecraft-plugin til Bukkit/Spigot-servere, som gør det muligt for serveroperatører og staff at blive helt usynlige for andre spillere. Det har til formål at levere en uopdagelig vanish-tilstand, der er velegnet til moderation og test, samtidig med at det tilbyder et API, så andre plugins kan interagere med vanish-tilstanden.

🎯 Formål

Pluginets kerneformål er moderation og administrativ overvågning: at lade betroet staff observere spilleradfærd uden at fremstå i playerlist, join/leave-beskeder eller som tilstedeværelse i verden for de fleste spillere. Det er beregnet til serverejere, administratorer og pluginudviklere, der har brug for en pålidelig vanish-implementering.

⚙️ Funktioner

• Skjuler vanished spillere fuldstændigt for andre spillere (synlighed i verden).
• Skjuler vanished spillere i spillerlisten (tab) med konfigurerbart udseende for observatører.
• Justerer det rapporterede antal online spillere/server list, når ProtocolLib er tilgængelig.
• Flerlaget tilladelsessystem til præcist at konfigurere, hvem der kan se hvem.
• Bevarer vanish-status på tværs af joins, genstarter og reloads.
• Valgfrie integrationspunkter, der kræver ProtocolLib for avancerede packet-baserede funktioner.
• Valgfri anbefaling om at installere OpenInv for bedre "silent chest"-adfærd.
• Offentlig VanishAPI til andre plugins: metoder til at skjule/vise spillere, forespørge usynlige spillere og lytte til PlayerHideEvent/PlayerShowEvent.

🧩 Hvem det er til

• Survival- og SMP-servere, der har brug for skjulte moderationsværktøjer.
• Servere, der ønsker et vanish API til andre moderations- eller hjælpeplugins.
• Administratorer, der har brug for konfigurerbare synlighedsregler og kontrol over tablist.

🏗️ Eksempler på brug

• En moderator bliver usynlig for at undersøge en grief-rapport uden at advare mistænkte.
• Et plugin forespørger VanishAPI for at udelukke vanished spillere fra gameplay-mekanikker eller rapporter.
• Serveroperatører skjuler deres tilstedeværelse under live-tests for at simulere forhold med kun spillere.

⚙️ Installation

📥 Opsætning

• Download den officielle plugin-JAR og læg den i serverens plugins/-mappe.
• Genstart serveren, og bekræft via konsolloggen, at SuperVanish er indlæst.
• Hvis du bruger ProtocolLib til udvidede funktioner, skal du også installere ProtocolLib og genstarte.

📦 Afhængigheder

• ProtocolLib (valgfrit): kræves til packet-baserede funktioner som justering af spillerantal og visse action-bar-funktioner.
• OpenInv (valgfri anbefaling): forbedrer silent chest-adfærd ved interaktion med inventories, mens man er vanished.

🧠 Tekniske noter

• Platform: implementeret som et Bukkit/Spigot-plugin og eksponerer et Java API til andre plugins.
• API: leverer VanishAPI med metoder til at skjule/vise spillere, tjekke vanish-status og hente lister over usynlige spillere; inkluderer PlayerHideEvent og PlayerShowEvent til event-baserede integrationer.
• Persistens: kan returnere lister over alle usynlige spillere (online og offline) via API; hentning af alle usynlige spillere kan involvere databasedrift og bør bruges forsigtigt uden for main thread.
• Licens: udgivet under MIT-licensen, og kildekoden er tilgængelig i projektets repository.

🤝 Hvornår dette plugin er nyttigt

Hvis du har brug for en vanish-implementering, der integrerer med andre plugins og understøtter nuancerede synlighedsregler til moderation, tilbyder SuperVanish et API-drevet, konfigurerbart vanish med valgfrie ProtocolLib/OpenInv-integrationer for forbedret adfærd.