Plugin Minecraft InteractiveChat

🔌 Despre InteractiveChat

InteractiveChat este un plugin Minecraft care îmbunătățește chatul din joc prin înlocuirea numelor simple ale jucătorilor și a cuvintelor-cheie cu conținut interactiv (mesaje la hover, acțiuni la click) și prin permiterea jucătorilor să afișeze iteme, inventare și ender chest-uri direct în chat. Este conceput să funcționeze peste pluginurile existente de formatare a chatului, modificând pachetele în loc să înlocuiască sistemele de chat.

🎯 Scop

InteractiveChat rezolvă problema chatului static, doar text, adăugând elemente interactive și placeholder-e bogate, astfel încât jucătorii să poată partaja detalii despre iteme/unelte și conținutul inventarului cu interacțiuni de hover și click. De asemenea, suportă funcționalitate cross-server pe rețele proxy, permițând funcții de chat interactiv pe serverele backend.

⚙️ Funcții

• Înlocuiește numele jucătorilor din chat cu conținut interactiv la hover/click.
• Afișează previzualizarea itemului din mână în chat printr-un cuvânt-cheie (de ex. [item]).
• Afișează conținutul inventarului jucătorului în chat printr-un cuvânt-cheie (de ex. [inv]) și alege aspectul de afișare.
• Afișează conținutul ender chest-ului în chat printr-un cuvânt-cheie (de ex. [ender]).
• Creează cuvinte-cheie/placeholder-e interactive personalizate pentru utilizare în chat.
• Menționarea jucătorilor cu notificări opționale (sunet, title, action bar, boss bar) atunci când sunt suportate de versiunea serverului.
• Suport cross-server pentru BungeeCord și Velocity atunci când este configurat pe proxy și pe backend-uri.
• Suportă placeholder-ele PlaceholderAPI și integrarea cu traducerea numelor materialelor itemelor în limba clientului.
• Coduri de culoare RGB și suport pentru fonturi personalizate pentru mesaje pe serverele care le suportă (funcțiile RGB necesită 1.16+).

🧩 Pentru cine este

• Administratori de server care doresc interacțiuni mai bogate în chat și conținut la hover/click.
• Rețele care folosesc proxy-uri (BungeeCord/Velocity) și au nevoie de chat interactiv între serverele backend.
• Comunități care vor ca jucătorii să poată arăta iteme sau inventare în chat fără moduri externe.

🏗️ Exemple de utilizare

• Un jucător tastează [item] în chatul global pentru a afișa un tooltip interactiv al itemului ținut în mână, pe care alții îl pot inspecta.
• Un moderator trimite un mesaj formatat în chat, folosind placeholder-e și previzualizări inline ale inventarului pentru suport sau verificare.
• O rețea proxy activează pluginul pe proxy și pe backend-uri, astfel încât mențiunile și placeholder-ele să funcționeze între servere.

⌨️ Comenzi

Notă: mai sus sunt incluse doar comenzile listate explicit de sursele oficiale. Node-urile de permisiune sunt incluse acolo unde pluginul le documentează; altfel, coloana permission afișează "nu este specificat".

🔐 Permissions

(Doar node-urile de permisiune menționate explicit în documentația oficială a pluginului sunt listate mai sus.)

⚙️ Instalare

📥 Configurare

• Descarcă JAR-ul oficial al pluginului și pluginurile dependință necesare.
• Pune InteractiveChat.jar (și JAR-urile dependință) în directorul plugins/ al serverului.
• Pornește serverul.
• Editează configurația pluginului dacă este necesar și repornește serverul pentru a aplica modificările.

📦 Dependențe

Dependențe confirmate necesare pe serverele backend (Spigot/Paper/etc.):

• ProtocolLib (sau) PacketEvents (+ modulul de packet relevant)
• PlaceholderAPI
• Vault

Note: dependențele nu sunt necesare pe software-ul proxy; dacă plănuiești să folosești pluginul cu BungeeCord sau Velocity, instalează InteractiveChat atât pe proxy, cât și pe serverele backend și activează opțiunea proxy/bungeecord în configurația InteractiveChat de pe fiecare server backend.

🧠 Note tehnice

• Pluginul modifică chatul la nivel de packet; necesită o bibliotecă de packet (ProtocolLib sau PacketEvents) pentru a intercepta/modifica mesajele pe serverele backend.
• Suport proxy: BungeeCord și Velocity sunt suportate; pentru a activa placeholder-ele și mențiunile cross-server, pluginul trebuie instalat pe proxy și pe toate serverele backend, cu opțiunea bungeecord activată în configurația fiecărui backend.
• PlaceholderAPI este folosit pentru rezolvarea placeholder-elor și necesită instalarea separată a expansion-urilor necesare pentru ca acele placeholder-e să funcționeze.
• Numele materialelor itemelor sunt traduse în limba clientului fiecărui jucător, acolo unde este cazul.
• Codurile de culoare RGB și tag-urile de font personalizate sunt suportate pe serverele/clienții care suportă aceste funcții (comportamentul RGB necesită suport server/client, disponibil în mod obișnuit în 1.16+).

🤝 Când este util acest plugin

Dacă vrei să adaugi previzualizări inspectabile pentru iteme/unelte, partajarea inventarului, cuvinte-cheie de chat clicabile și funcții de chat interactiv cross-server, păstrând în același timp pluginul tău existent de formatare a chatului, InteractiveChat oferă o integrare la nivel de packet care suprapune conținut interactiv peste sistemele standard de chat.