Plugin Minecraft InteractiveChat

🔌 Informazioni su InteractiveChat

InteractiveChat è un plugin per Minecraft che migliora il chat di gioco sostituendo i nomi semplici dei giocatori e le parole chiave con contenuti interattivi (messaggi al passaggio del mouse, azioni di clic) e permettendo ai giocatori di mostrare oggetti, inventari e forzieri dell'Ender direttamente nel chat. È progettato per funzionare sopra i plugin di formattazione chat esistenti, modificando i pacchetti invece di sostituire i sistemi di chat.

🎯 Scopo

InteractiveChat risolve il problema di un chat statico, solo testo, aggiungendo elementi interattivi e placeholder ricchi così che i giocatori possano condividere dettagli di oggetti/strumenti e contenuti dell'inventario con interazioni di hover e clic. Supporta anche funzioni tra server su reti con proxy, consentendo funzionalità di chat interattiva tra i server backend.

⚙️ Funzionalità

• Sostituisce i nomi dei giocatori nel chat con contenuti interattivi hover/clic.
• Mostra l'anteprima dell'oggetto in mano nel chat tramite una parola chiave (ad es. [item]).
• Mostra il contenuto dell'inventario del giocatore nel chat tramite una parola chiave (ad es. [inv]) e consente di scegliere i layout di visualizzazione.
• Mostra il contenuto del forziere dell'Ender nel chat tramite una parola chiave (ad es. [ender]).
• Crea parole chiave/placeholder interattivi personalizzati da usare nel chat.
• Menzione dei giocatori con notifiche opzionali (suono, titolo, action bar, boss bar) quando supportato dalla versione del server.
• Supporto tra server per BungeeCord e Velocity quando configurato su proxy e backend.
• Supporta i placeholder di PlaceholderAPI e si integra con la traduzione dei nomi dei materiali degli oggetti nella lingua del client.
• Codici colore RGB e supporto a font personalizzati per i messaggi su server che li supportano (le funzionalità RGB richiedono 1.16+).

🧩 A chi è rivolto

• Amministratori di server che desiderano interazioni chat più ricche e contenuti hover/cliccabili.
• Reti che usano proxy (BungeeCord/Velocity) e hanno bisogno di chat interattiva tra server backend.
• समुदायà che vogliono far mostrare ai giocatori oggetti o inventari nel chat senza mod esterne.

🏗️ Esempi di utilizzo

• Un giocatore digita [item] nel chat globale per mostrare un tooltip interattivo dell'oggetto che tiene in mano, così che gli altri possano ispezionarlo.
• Un moderatore invia un messaggio di chat formattato usando placeholder e anteprime inline dell'inventario per supporto o revisione.
• Una rete con proxy abilita il plugin sul proxy e sui backend in modo che menzioni e placeholder funzionino tra i server.

⌨️ Comandi

Nota: sopra sono presenti solo i comandi esplicitamente elencati dalle fonti ufficiali. I nodi di permesso sono inclusi quando il plugin li documenta; altrimenti la colonna del permesso mostra non specificato.

🔐 Permessi

(Sono elencati sopra solo i nodi di permesso esplicitamente forniti dalla documentazione ufficiale del plugin.)

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin e i plugin di dipendenza richiesti.
• Inserisci InteractiveChat.jar (e i jar di dipendenza) nella directory plugins/ del server.
• Avvia il server.
• Modifica la configurazione del plugin se necessario e riavvia il server per applicare le modifiche.

📦 Dipendenze

Dipendenze confermate richieste sui server backend (Spigot/Paper/etc.):

• ProtocolLib (oppure) PacketEvents (+ modulo pacchetto pertinente)
• PlaceholderAPI
• Vault

Note: le dipendenze non sono richieste sul software proxy; se prevedi di usare il plugin con BungeeCord o Velocity, installa InteractiveChat sia sul proxy sia sui server backend e abilita l'opzione proxy/bungeecord nella configurazione di InteractiveChat su ciascun server backend.

🧠 Note tecniche

• Il plugin modifica il chat a livello di pacchetto; richiede una libreria per pacchetti (ProtocolLib o PacketEvents) per intercettare/modificare i messaggi sui server backend.
• Supporto proxy: BungeeCord e Velocity sono supportati; per abilitare placeholder e menzioni tra server, il plugin deve essere installato sul proxy e su tutti i server backend, con l'opzione bungeecord abilitata nella configurazione di ogni backend.
• PlaceholderAPI viene usato per la risoluzione dei placeholder e richiede che eventuali espansioni necessarie siano installate separatamente affinché quei placeholder funzionino.
• I nomi dei materiali degli oggetti vengono tradotti nella lingua del client di ciascun giocatore, dove applicabile.
• I codici colore RGB e i tag di font personalizzati sono supportati per server/client che supportano queste funzionalità (il comportamento RGB richiede supporto server/client, comunemente disponibile in 1.16+).

🤝 Quando questo plugin è utile

Se vuoi aggiungere anteprime ispezionabili di oggetti/strumenti, condivisione dell'inventario, parole chiave cliccabili nel chat e funzioni di chat interattiva tra server mantenendo il plugin di formattazione chat che già usi, InteractiveChat offre un'integrazione a livello di pacchetto che sovrappone contenuti interattivi ai sistemi di chat standard.