Minecraft-Plugin InteractiveChat

🔌 Über InteractiveChat

InteractiveChat ist ein Minecraft-Plugin, das den In-Game-Chat verbessert, indem es einfache Spielernamen und Schlüsselwörter durch interaktive Inhalte (Hover-Nachrichten, Klick-Aktionen) ersetzt und es Spielern ermöglicht, Gegenstände, Inventare und Ender-Truhen direkt im Chat anzuzeigen. Es ist dafür ausgelegt, auf vorhandenen Chat-Formatierungs-Plugins aufzubauen, indem es Pakete verändert statt Chatsysteme zu ersetzen.

🎯 Zweck

InteractiveChat löst das Problem eines statischen, nur aus Text bestehenden Chats, indem es interaktive Elemente und reichhaltige Platzhalter hinzufügt, damit Spieler Details zu Gegenständen/Werkzeugen und Inventarinhalte mit Hover- und Klick-Interaktionen teilen können. Außerdem unterstützt es serverübergreifende Funktionen in Proxy-Netzwerken und ermöglicht interaktive Chat-Funktionen über Backend-Server hinweg.

⚙️ Funktionen

• Ersetzt Spielernamen im Chat durch interaktive Hover-/Klick-Inhalte.
• Zeigt eine Vorschau des Items in der Hand im Chat über ein Schlüsselwort an (z. B. [item]).
• Zeigt den Inhalt des Spielerinventars im Chat über ein Schlüsselwort an (z. B. [inv]) und ermöglicht die Auswahl von Anzeigelayouts.
• Zeigt den Inhalt der Ender-Truhe im Chat über ein Schlüsselwort an (z. B. [ender]).
• Erstellt benutzerdefinierte interaktive Schlüsselwörter/Platzhalter für den Chat.
• Spieler-Erwähnungen mit optionalen Benachrichtigungen (Sound, Titel, Actionbar, Bossbar), wenn die Serverversion dies unterstützt.
• Serverübergreifende Unterstützung für BungeeCord und Velocity, wenn auf Proxy und Backends konfiguriert.
• Unterstützt PlaceholderAPI-Platzhalter und integriert die Übersetzung von Item-Materialnamen in die Client-Sprache.
• RGB-Farbcodes und benutzerdefinierte Schriftarten werden für Nachrichten auf Servern unterstützt, die dies können (RGB-Verhalten erfordert 1.16+).

🧩 Für wen es gedacht ist

• Serveradministratoren, die reichere Chat-Interaktionen und Hover-/Klick-Inhalte möchten.
• Netzwerke mit Proxys (BungeeCord/Velocity), die interaktiven Chat über Backend-Server hinweg benötigen.
• Communities, die möchten, dass Spieler Gegenstände oder Inventare im Chat ohne externe Mods zeigen können.

🏗️ Beispielanwendungen

• Ein Spieler tippt [item] im globalen Chat, um einen interaktiven Tooltip seines gehaltenen Gegenstands zu zeigen, den andere ansehen können.
• Ein Moderator sendet eine formatierte Chat-Nachricht mit Platzhaltern und Inline-Inventarvorschauen für Support oder Prüfung.
• Ein Proxy-Netzwerk aktiviert das Plugin auf Proxy und Backends, damit Erwähnungen und Platzhalter serverübergreifend funktionieren.

⌨️ Befehle

Hinweis: Oben sind nur Befehle aufgeführt, die von offiziellen Quellen ausdrücklich genannt werden. Berechtigungs-Knoten werden dort aufgenommen, wo das Plugin sie dokumentiert; andernfalls zeigt die Berechtigungsspalte nicht angegeben.

🔐 Berechtigungen

(Nur die von der offiziellen Dokumentation des Plugins ausdrücklich angegebenen Berechtigungs-Knoten sind oben aufgeführt.)

⚙️ Installation

📥 Einrichtung

• Lade das offizielle Plugin-JAR und die benötigten Abhängigkeits-Plugins herunter.
• Lege InteractiveChat.jar (und die Abhängigkeits-JARs) in das Verzeichnis plugins/ des Servers.
• Starte den Server.
• Bearbeite bei Bedarf die Plugin-Konfiguration und starte den Server neu, um Änderungen anzuwenden.

📦 Abhängigkeiten

Bestätigte Abhängigkeiten, die auf Backend-Servern (Spigot/Paper/etc.) erforderlich sind:

• ProtocolLib (oder) PacketEvents (+ passendes Paketmodul)
• PlaceholderAPI
• Vault

Hinweise: Abhängigkeiten sind auf Proxy-Software nicht erforderlich; wenn du das Plugin mit BungeeCord oder Velocity verwenden möchtest, installiere InteractiveChat sowohl auf dem Proxy als auch auf den Backend-Servern und aktiviere die Proxy/Bungeecord-Option in der Konfiguration von InteractiveChat auf jedem Backend-Server.

🧠 Technische Hinweise

• Das Plugin verändert den Chat auf Paketebene; dafür wird eine Paketbibliothek (ProtocolLib oder PacketEvents) benötigt, um Nachrichten auf Backend-Servern abzufangen bzw. zu verändern.
• Proxy-Unterstützung: BungeeCord und Velocity werden unterstützt; um serverübergreifende Platzhalter und Erwähnungen zu aktivieren, muss das Plugin auf dem Proxy und auf allen Backend-Servern installiert sein, mit aktivierter bungeecord-Option in der Konfiguration jedes Backends.
• PlaceholderAPI wird zur Auflösung von Platzhaltern verwendet und erfordert, dass benötigte Erweiterungen separat installiert werden, damit diese Platzhalter funktionieren.
• Materialnamen von Gegenständen werden gegebenenfalls in die Client-Sprache jedes Spielers übersetzt.
• RGB-Farbcodes und benutzerdefinierte Schriftarten werden für Server/Clients unterstützt, die diese Funktionen unterstützen (RGB-Verhalten erfordert Server-/Client-Unterstützung, die üblicherweise ab 1.16 verfügbar ist).

🤝 Wann dieses Plugin nützlich ist

Wenn du Vorschauen für prüfbare Gegenstände/Werkzeuge, das Teilen von Inventaren, klickbare Chat-Schlüsselwörter und serverübergreifende interaktive Chat-Funktionen hinzufügen möchtest, während du dein bestehendes Chat-Formatierungs-Plugin beibehältst, bietet InteractiveChat eine Integration auf Paketebene, die interaktive Inhalte über die Standard-Chatsysteme legt.