Minecraft plugin InteractiveChat

🔌 Over InteractiveChat

InteractiveChat is een Minecraft-plugin die de in-game chat verbetert door gewone spelersnamen en zoekwoorden te vervangen door interactieve content (hoverberichten, klikacties) en door spelers items, inventarissen en ender chests direct in de chat te laten tonen. De plugin is ontworpen om bovenop bestaande chat-formattingplugins te werken door packets te wijzigen in plaats van chatsystemen te vervangen.

🎯 Doel

InteractiveChat lost het probleem van statische, alleen-tekst chat op door interactieve elementen en rijke placeholders toe te voegen, zodat spelers item-/tooldetails en inventarisinhoud kunnen delen met hover- en klikinteracties. Het ondersteunt ook cross-server functionaliteit op proxy-netwerken, waardoor interactieve chatfuncties over backend-servers heen werken.

⚙️ Functies

• Vervang spelersnamen in chat door interactieve content met hover/klik.
• Toon een preview van het item in je hand in chat via een zoekwoord (bijv. [item]).
• Toon de inhoud van de inventaris van een speler in chat via een zoekwoord (bijv. [inv]) en kies weergavelay-outs.
• Toon de inhoud van een ender chest in chat via een zoekwoord (bijv. [ender]).
• Maak aangepaste interactieve zoekwoorden/placeholders voor gebruik in chat.
• Spelers vermelden met optionele meldingen (geluid, title, action bar, boss bar) wanneer ondersteund door de serverversie.
• Cross-server ondersteuning voor BungeeCord en Velocity wanneer geconfigureerd op proxy en backend-servers.
• Ondersteunt PlaceholderAPI-placeholders en integreert met de vertaling van itemmateriaalnamen naar de clienttaal.
• RGB-kleurcodes en ondersteuning voor aangepaste fonts voor berichten op servers die dit ondersteunen (voor RGB-gedrag is 1.16+ vereist).

🧩 Voor wie het is

• Serverbeheerders die rijkere chatinteracties en hover-/klikbare content willen.
• Netwerken met proxies (BungeeCord/Velocity) die interactieve chat over backend-servers nodig hebben.
• Communities die willen dat spelers items of inventarissen in chat laten zien zonder externe mods.

🏗️ Voorbeeldgebruik

• Een speler typt [item] in globale chat om een interactieve tooltip van het item in zijn hand te tonen, zodat anderen het kunnen bekijken.
• Een moderator stuurt een opgemaakte chatbericht met placeholders en inline inventarispreview voor support of controle.
• Een proxy-netwerk zet de plugin aan op proxy en backend-servers zodat mentions en placeholders over servers heen werken.

⌨️ Commando's

Opmerking: alleen commando's die expliciet door officiële bronnen worden vermeld, staan hierboven. Permission nodes zijn opgenomen waar de plugin ze documenteert; anders toont de kolom permission "niet gespecificeerd".

🔐 Permissions

(Alleen permission nodes die expliciet in de officiële documentatie van de plugin staan, zijn hierboven vermeld.)

⚙️ Installatie

📥 Setup

• Download de officiële plugin-JAR en de vereiste dependencyplugins.
• Plaats InteractiveChat.jar (en dependency-jars) in de plugins/-map van de server.
• Start de server.
• Bewerk indien nodig de pluginconfiguratie en herstart de server om configuratiewijzigingen toe te passen.

📦 Afhankelijkheden

Bevestigde afhankelijkheden die vereist zijn op backend-servers (Spigot/Paper/etc.):

• ProtocolLib (of) PacketEvents (+ relevante packetmodule)
• PlaceholderAPI
• Vault

Opmerkingen: afhankelijkheden zijn niet vereist op proxysoftware; als je van plan bent de plugin met BungeeCord of Velocity te gebruiken, installeer InteractiveChat dan op zowel de proxy als de backend-servers en schakel de proxy/bungeecord-optie in de configuratie van InteractiveChat op elke backendserver in.

🧠 Technische notities

• De plugin wijzigt chat op packetniveau; hiervoor is een packetbibliotheek (ProtocolLib of PacketEvents) nodig om berichten op backend-servers te onderscheppen/wijzigen.
• Proxyondersteuning: BungeeCord en Velocity worden ondersteund; om cross-server placeholders en mentions in te schakelen, moet de plugin op de proxy en op alle backend-servers geïnstalleerd zijn met de bungeecord-optie ingeschakeld in de configuratie van elke backend.
• PlaceholderAPI wordt gebruikt voor het oplossen van placeholders en vereist dat eventuele benodigde expansions apart geïnstalleerd zijn om die placeholders te laten werken.
• Itemmateriaalnamen worden, waar van toepassing, vertaald naar de clienttaal van elke speler.
• RGB-kleurcodes en aangepaste font-tags worden ondersteund voor servers/clients die deze functies ondersteunen (RGB-gedrag vereist server-/clientondersteuning die meestal beschikbaar is vanaf 1.16+).

🤝 Wanneer deze plugin nuttig is

Als je inspecteerbare item-/toolpreviews, het delen van inventarissen, klikbare chatzoekwoorden en interactieve chatfuncties over servers heen wilt toevoegen terwijl je je bestaande chat-formattingplugin behoudt, biedt InteractiveChat een packetniveau-integratie die interactieve content bovenop standaard chatsystemen plaatst.