Plugin Minecraft SuperVanish

🔌 Informazioni su SuperVanish

SuperVanish è un plugin Minecraft per server Bukkit/Spigot che consente agli operatori e allo staff del server di diventare completamente invisibili agli altri giocatori. L'obiettivo è fornire uno stato vanish non rilevabile, adatto alla moderazione e ai test, esponendo al tempo stesso una API per permettere ad altri plugin di interagire con lo stato vanish.

🎯 Obiettivo

Lo scopo principale del plugin è la moderazione e il monitoraggio amministrativo: permettere allo staff fidato di osservare il comportamento dei giocatori senza apparire nella lista giocatori, nei messaggi di ingresso/uscita o nella presenza nel mondo per la maggior parte dei giocatori. È pensato per proprietari di server, amministratori e sviluppatori di plugin che hanno bisogno di un'implementazione vanish affidabile.

⚙️ Funzionalità

• Nasconde completamente i giocatori in vanish agli altri giocatori (visibilità nel mondo).
• Nasconde i giocatori in vanish nella lista giocatori (tab) con aspetto configurabile per gli osservatori.
• Regola il numero di giocatori online/la lista del server riportati quando ProtocolLib è disponibile.
• Modello di permessi a livelli per configurare con precisione chi può vedere chi.
• Mantiene lo stato vanish tra accessi, riavvii e ricaricamenti.
• Punti di integrazione opzionali che richiedono ProtocolLib per funzionalità avanzate basate sui pacchetti.
• Raccomandazione opzionale di installare OpenInv per migliorare il comportamento del "silent chest".
• VanishAPI pubblica per altri plugin: metodi per nascondere/mostrare i giocatori, interrogare i giocatori invisibili e ascoltare PlayerHideEvent/PlayerShowEvent.

🧩 A chi è destinato

• Server Survival e SMP che hanno bisogno di strumenti di moderazione furtiva.
• Server che vogliono una API vanish per altri plugin di moderazione o utilità.
• Amministratori che richiedono regole di visibilità configurabili e controllo della tablist.

🏗️ Casi d'uso di esempio

• Un moderatore diventa invisibile per indagare su una segnalazione di griefing senza allertare i sospetti.
• Un plugin interroga VanishAPI per escludere i giocatori in vanish da meccaniche di gioco o report.
• Gli operatori del server nascondono la propria presenza durante test live per simulare condizioni solo giocatore.

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin e posizionalo nella directory plugins/ del tuo server.
• Riavvia il server e verifica nei log della console che SuperVanish sia stato caricato.
• Se usi ProtocolLib per funzionalità estese, installa anche ProtocolLib e riavvia.

📦 Dipendenze

• ProtocolLib (opzionale): richiesto per funzionalità basate sui pacchetti come la regolazione del numero di giocatori e alcune funzioni della action bar.
• OpenInv (raccomandazione opzionale): migliora il comportamento del "silent chest" quando si interagisce con gli inventari mentre si è in vanish.

🧠 Note tecniche

• Piattaforma: implementato come plugin Bukkit/Spigot e fornisce una API Java per altri plugin.
• API: offre VanishAPI con metodi per nascondere/mostrare i giocatori, controllare lo stato vanish e recuperare elenchi di giocatori invisibili; include PlayerHideEvent e PlayerShowEvent per integrazioni basate sugli eventi.
• Persistenza: può restituire elenchi di tutti i giocatori invisibili (online e offline) tramite l'API; recuperare tutti i giocatori invisibili può comportare l'accesso al database e va usato con cautela fuori dal thread principale.
• Licenza: rilasciato con licenza MIT e il codice sorgente è disponibile nel repository del progetto.

🤝 Quando questo plugin è utile

Se hai bisogno di un'implementazione vanish che si integri con altri plugin e supporti regole di visibilità sfumate per la moderazione, SuperVanish offre un vanish configurabile basato su API, con integrazioni opzionali ProtocolLib/OpenInv per un comportamento migliore.