Minecraft plugin SuperVanish

🔌 O SuperVanish

SuperVanish je Minecraft plugin pro servery Bukkit/Spigot, který umožňuje provozovatelům serveru a personálu stát se pro ostatní hráče úplně neviditelnými. Jeho cílem je poskytnout neodhalitelný stav vanish vhodný pro moderaci a testování a zároveň nabídnout API, aby s ním mohly pracovat i další pluginy.

🎯 Účel

Hlavním účelem pluginu je moderace a administrativní dohled: umožnit důvěryhodnému personálu sledovat chování hráčů, aniž by se zobrazovali v playerlistu, zprávách o připojení/odpojení nebo ve světě pro většinu hráčů. Je určen pro majitele serverů, administrátory a vývojáře pluginů, kteří potřebují spolehlivou implementaci vanish.

⚙️ Funkce

• Úplně skrývá vanished hráče před ostatními hráči (viditelnost ve světě).
• Skrývá vanished hráče v seznamu hráčů (tab) s nastavitelným vzhledem pro pozorovatele.
• Upravuje hlášený počet online hráčů/server list, když je k dispozici ProtocolLib.
• Vícevrstvý model oprávnění pro přesné nastavení toho, kdo koho může vidět.
• Zachovává stav vanish při připojení, restartu a reloadu.
• Volitelná integrační místa vyžadující ProtocolLib pro pokročilé funkce založené na paketech.
• Volitelné doporučení nainstalovat OpenInv pro lepší chování "silent chest".
• Veřejné VanishAPI pro další pluginy: metody pro skrytí/zobrazení hráčů, dotaz na neviditelné hráče a poslouchání PlayerHideEvent/PlayerShowEvent.

🧩 Pro koho je určen

• Servery Survival a SMP, které potřebují utajené nástroje pro moderaci.
• Servery, které chtějí vanish API pro další moderační nebo užitečné pluginy.
• Administrátory, kteří potřebují konfigurovatelná pravidla viditelnosti a kontrolu tablistu.

🏗️ Příklady použití

• Moderátor se stane neviditelným, aby prošetřil hlášení o griefu, aniž by varoval podezřelé.
• Plugin dotazuje VanishAPI, aby vyloučil vanished hráče z herních mechanismů nebo reportů.
• Provozovatelé serveru skrývají svou přítomnost během živých testů, aby simulovali podmínky pouze pro hráče.

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu a umístěte jej do adresáře plugins/ vašeho serveru.
• Restartujte server a ověřte v konzolových logách, že se SuperVanish načetl.
• Pokud pro rozšířené funkce používáte ProtocolLib, nainstalujte také ProtocolLib a restartujte.

📦 Závislosti

• ProtocolLib (volitelné): vyžadováno pro funkcionality založené na paketech, jako je úprava počtu hráčů a některé funkce action-bar.
• OpenInv (doporučení volitelné): zlepšuje chování silent chest při interakci s inventáři, když jste vanished.

🧠 Technické poznámky

• Platforma: implementováno jako Bukkit/Spigot plugin a nabízí Java API pro další pluginy.
• API: poskytuje VanishAPI s metodami pro skrytí/zobrazení hráčů, kontrolu stavu vanish a získání seznamů neviditelných hráčů; zahrnuje PlayerHideEvent a PlayerShowEvent pro integrace založené na událostech.
• Perzistence: přes API může vracet seznamy všech neviditelných hráčů (online i offline); získání všech neviditelných hráčů může zahrnovat přístup k databázi a mělo by být používáno opatrně mimo main thread.
• Licence: vydáno pod licencí MIT a zdrojový kód je k dispozici v repozitáři projektu.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete implementaci vanish, která se integruje s dalšími pluginy a podporuje jemně nastavená pravidla viditelnosti pro moderaci, SuperVanish poskytuje konfigurovatelný vanish založený na API s volitelnými integracemi ProtocolLib/OpenInv pro lepší chování.