Minecraft-plugin SuperVanish

🔌 Om SuperVanish

SuperVanish är ett Minecraft-plugin för Bukkit/Spigot-servrar som låter serveroperatörer och personal bli helt osynliga för andra spelare. Det är utformat för att ge ett odetekterbart vanish-läge som passar för moderering och testning, samtidigt som det exponerar ett API så att andra plugins kan interagera med vanish-läget.

🎯 Syfte

Pluginets kärnsyfte är moderering och administrativ övervakning: låt betrodd personal observera spelarbeteende utan att synas i spelarlistan, join/leave-meddelanden eller som närvaro i världen för de flesta spelare. Det är avsett för serverägare, administratörer och pluginutvecklare som behöver en tillförlitlig vanish-implementation.

⚙️ Funktioner

• Döljer helt vanished spelare från andra spelare (synlighet i världen).
• Döljer vanished spelare i spelarlistan (tab) med konfigurerbart utseende för observatörer.
• Justerar rapporterat antal online-spelare/server list när ProtocolLib finns tillgängligt.
• Flerskiktad behörighetsmodell för att exakt konfigurera vem som kan se vem.
• Behåller vanish-läget mellan anslutningar, omstarter och reloads.
• Valfria integrationspunkter som kräver ProtocolLib för avancerade paketbaserade funktioner.
• Valfri rekommendation att installera OpenInv för förbättrat "silent chest"-beteende.
• Publik VanishAPI för andra plugins: metoder för att dölja/visa spelare, fråga efter osynliga spelare och lyssna på PlayerHideEvent/PlayerShowEvent.

🧩 Vem den är för

• Survival- och SMP-servrar som behöver smygverktyg för moderering.
• Servrar som vill ha ett vanish API för andra modererings- eller hjälpprograms-plugins.
• Administratörer som behöver konfigurerbara synlighetsregler och kontroll över tablist.

🏗️ Exempel på användning

• En moderator blir osynlig för att utreda en grief-rapport utan att varna misstänkta.
• Ett plugin frågar VanishAPI för att utesluta vanished spelare från spelmekanik eller rapporter.
• Serveroperatörer döljer sin närvaro under live-tester för att simulera förhållanden med endast spelare.

⚙️ Installation

📥 Konfiguration

• Ladda ner den officiella plugin-JAR-filen och lägg den i serverns plugins/-katalog.
• Starta om servern och kontrollera konsolloggarna för att verifiera att SuperVanish har laddats.
• Om du använder ProtocolLib för utökade funktioner, installera även ProtocolLib och starta om.

📦 Beroenden

• ProtocolLib (valfritt): krävs för paketbaserade funktioner som att justera spelarantalet och vissa action-bar-funktioner.
• OpenInv (valfri rekommendation): förbättrar silent chest-beteendet när man interagerar med inventarier medan man är vanished.

🧠 Tekniska anteckningar

• Plattform: implementerat som ett Bukkit/Spigot-plugin och exponerar ett Java API för andra plugins.
• API: tillhandahåller VanishAPI med metoder för att dölja/visa spelare, kontrollera vanish-status och hämta listor över osynliga spelare; inkluderar PlayerHideEvent och PlayerShowEvent för händelsestyrda integrationer.
• Persistens: kan returnera listor över alla osynliga spelare (online och offline) via API; hämtning av alla osynliga spelare kan innebära databasanrop och bör användas försiktigt utanför main thread.
• Licens: släppt under MIT-licensen och källkoden finns i projektets repository.

🤝 När detta plugin är användbart

Om du behöver en vanish-implementation som integreras med andra plugins och stöder nyanserade synlighetsregler för moderering, erbjuder SuperVanish ett API-drivet, konfigurerbart vanish med valfria ProtocolLib/OpenInv-integrationer för förbättrat beteende.