Plugin Minecraft SuperVanish

🔌 O SuperVanish

SuperVanish to plugin Minecraft dla serwerów Bukkit/Spigot, który pozwala operatorom serwera i administracji stać się całkowicie niewidocznymi dla innych graczy. Jego celem jest zapewnienie niewykrywalnego stanu vanish, odpowiedniego do moderacji i testów, przy jednoczesnym udostępnieniu API, aby inne pluginy mogły współpracować ze stanem vanish.

🎯 Cel

Głównym celem pluginu jest moderacja i nadzór administracyjny: pozwala zaufanej administracji obserwować zachowanie graczy bez pojawiania się na liście graczy, w wiadomościach o dołączeniu/wyjściu ani w widoczności w świecie dla większości graczy. Jest przeznaczony dla właścicieli serwerów, administratorów i twórców pluginów, którzy potrzebują niezawodnej implementacji vanish.

⚙️ Funkcje

• Całkowicie ukrywa graczy w vanish przed innymi graczami (widoczność w świecie).
• Ukrywa graczy w vanish na liście graczy (tab) z konfigurowalnym wyglądem dla obserwatorów.
• Dostosowuje zgłaszaną liczbę graczy online/listę serwera, gdy ProtocolLib jest dostępny.
• Wielowarstwowy model uprawnień do precyzyjnej konfiguracji, kto kogo może widzieć.
• Zachowuje stan vanish po dołączeniu, restartach i przeładowaniach.
• Opcjonalne punkty integracji wymagające ProtocolLib dla zaawansowanych funkcji opartych na pakietach.
• Opcjonalna rekomendacja instalacji OpenInv dla lepszego działania "silent chest".
• Publiczne VanishAPI dla innych pluginów: metody ukrywania/pokazywania graczy, sprawdzania niewidocznych graczy i nasłuchiwania PlayerHideEvent/PlayerShowEvent.

🧩 Dla kogo jest

• Serwery Survival i SMP, które potrzebują narzędzi do dyskretnej moderacji.
• Serwery, które chcą API vanish dla innych pluginów moderacyjnych lub użytkowych.
• Administratorzy, którzy potrzebują konfigurowalnych zasad widoczności i kontroli tablisty.

🏗️ Przykładowe zastosowania

• Moderator staje się niewidoczny, aby zbadać zgłoszenie o griefing bez ostrzegania podejrzanych.
• Plugin odwołuje się do VanishAPI, aby wykluczyć graczy w vanish z mechanik gry lub raportów.
• Operatorzy serwera ukrywają swoją obecność podczas testów na żywo, aby symulować warunki tylko dla graczy.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu i umieść go w katalogu plugins/ na swoim serwerze.
• Uruchom ponownie serwer i sprawdź w logach konsoli, czy SuperVanish został załadowany.
• Jeśli używasz ProtocolLib do rozszerzonych funkcji, zainstaluj także ProtocolLib i uruchom ponownie.

📦 Zależności

• ProtocolLib (opcjonalnie): wymagany do funkcji opartych na pakietach, takich jak dostosowywanie liczby graczy i niektóre funkcje action bar.
• OpenInv (opcjonalna rekomendacja): poprawia działanie silent chest podczas interakcji z ekwipunkiem, gdy jesteś w vanish.

🧠 Uwagi techniczne

• Platforma: zaimplementowany jako plugin Bukkit/Spigot i udostępnia Java API dla innych pluginów.
• API: udostępnia VanishAPI z metodami ukrywania/pokazywania graczy, sprawdzania stanu vanish i pobierania list niewidocznych graczy; zawiera PlayerHideEvent i PlayerShowEvent do integracji opartej na zdarzeniach.
• Trwałość: może zwracać listy wszystkich niewidocznych graczy (online i offline) przez API; pobieranie wszystkich niewidocznych graczy może wymagać dostępu do bazy danych i powinno być używane ostrożnie poza głównym wątkiem.
• Licencja: wydany na licencji MIT, a kod źródłowy jest dostępny w repozytorium projektu.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz implementacji vanish, która integruje się z innymi pluginami i obsługuje niuanse reguł widoczności dla moderacji, SuperVanish zapewnia konfigurowalny vanish oparty na API, z opcjonalnymi integracjami ProtocolLib/OpenInv dla lepszego działania.