Plugin Minecraft SuperVanish

🔌 Despre SuperVanish

SuperVanish este un plugin Minecraft pentru servere Bukkit/Spigot care le permite operatorilor serverului și membrilor staff să devină complet invizibili pentru ceilalți jucători. Scopul său este să ofere o stare vanish nedetectabilă, potrivită pentru moderare și testare, oferind în același timp un API pentru ca alte pluginuri să poată interacționa cu starea vanish.

🎯 Scop

Scopul de bază al pluginului este moderarea și monitorizarea administrativă: le permite membrilor staff de încredere să observe comportamentul jucătorilor fără a apărea în playerlist, în mesajele de intrare/ieșire sau în prezența din lume pentru majoritatea jucătorilor. Este destinat proprietarilor de servere, administratorilor și dezvoltatorilor de pluginuri care au nevoie de o implementare vanish fiabilă.

⚙️ Funcții

• Ascunde complet jucătorii vanished de ceilalți jucători (vizibilitate în lume).
• Ascunde jucătorii vanished în lista de jucători (tab) cu o apariție configurabilă pentru observatori.
• Ajustează numărul raportat de jucători online/server list atunci când ProtocolLib este disponibil.
• Model de permisiuni pe mai multe niveluri pentru a configura precis cine pe cine poate vedea.
• Păstrează starea vanish la join, restart și reload.
• Puncte opționale de integrare care necesită ProtocolLib pentru funcții avansate bazate pe pachete.
• Recomandare opțională de instalare a OpenInv pentru un comportament mai bun al "silent chest".
• VanishAPI public pentru alte pluginuri: metode pentru a ascunde/arăta jucători, a interoga jucătorii invizibili și a asculta PlayerHideEvent/PlayerShowEvent.

🧩 Pentru cine este

• Servere Survival și SMP care au nevoie de instrumente de moderare discretă.
• Servere care doresc un API vanish pentru alte pluginuri de moderare sau utilitare.
• Administratori care au nevoie de reguli de vizibilitate configurabile și control asupra tablist.

🏗️ Exemple de utilizare

• Un moderator devine invizibil pentru a investiga un raport de grief fără a alerta suspecții.
• Un plugin interoghează VanishAPI pentru a exclude jucătorii vanished din mecanici de joc sau rapoarte.
• Operatorii serverului își ascund prezența în timpul testelor live pentru a simula condiții doar cu jucători.

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul oficial al pluginului și plasați-l în directorul plugins/ al serverului dvs.
• Reporniți serverul și verificați logurile din consolă pentru a confirma că SuperVanish s-a încărcat.
• Dacă folosiți ProtocolLib pentru funcții extinse, instalați și ProtocolLib și reporniți.

📦 Dependențe

• ProtocolLib (opțional): necesar pentru funcții bazate pe pachete, cum ar fi ajustarea numărului de jucători și anumite funcții action-bar.
• OpenInv (recomandare opțională): îmbunătățește comportamentul silent chest atunci când interacționați cu inventarele în timp ce sunteți vanish.

🧠 Note tehnice

• Platformă: implementat ca plugin Bukkit/Spigot și oferă un API Java pentru alte pluginuri.
• API: oferă VanishAPI cu metode pentru a ascunde/arăta jucători, a verifica starea vanish și a obține liste de jucători invizibili; include PlayerHideEvent și PlayerShowEvent pentru integrări bazate pe evenimente.
• Persistență: poate returna prin API liste cu toți jucătorii invizibili (online și offline); obținerea tuturor jucătorilor invizibili poate implica acces la baza de date și ar trebui folosită cu atenție în afara main thread.
• Licență: lansat sub licența MIT, iar codul sursă este disponibil în repository-ul proiectului.

🤝 Când este util acest plugin

Dacă aveți nevoie de o implementare vanish care se integrează cu alte pluginuri și suportă reguli nuanțate de vizibilitate pentru moderare, SuperVanish oferă un vanish configurabil, bazat pe API, cu integrări opționale ProtocolLib/OpenInv pentru un comportament îmbunătățit.