Minecraft-Plugin EssentialsDiscord

🔌 Über EssentialsX Discord

EssentialsX Discord (verteilt als das EssentialsDiscord-Modul) ist ein offizielles EssentialsX-Modul, das einen Minecraft-Server mit einem Discord-Server verbindet. Es läuft als Plugin-JAR neben dem Kernmodul von EssentialsX und verbindet sich über ein konfiguriertes Bot-Token mit Discord, um Chat und Ereignisse weiterzuleiten und Discord-seitige Interaktionen über eine kleine API bereitzustellen.

🎯 Zweck

Der Hauptzweck des Moduls ist zweigeteilt: ausgewählte Minecraft-Chats/Ereignisse an Discord-Kanäle weiterleiten und ausgewählte Discord-Nachrichten/Befehle in den Minecraft-Server weiterleiten. Es richtet sich an Server-Administratoren, die eine direkte, konfigurierbare Kommunikation und eine begrenzte Fernsteuerung zwischen Discord und einem auf EssentialsX basierenden Minecraft-Server möchten.

⚙️ Funktionen

• Konfigurierbare Kanalzuordnung für verschiedene Nachrichtentypen (Chat, Beitritt/Verlassen, Team usw.).
• Weiterleitung von Minecraft-Chat an Discord und optional Weiterleitung von Discord-Nachrichten in den Minecraft-Chat.
• Discord-seitige Slash-Befehle, die Konsolenbefehle ausführen, Spielern Nachrichten senden und Spielerlisten anzeigen können (konfigurierbar und durch Rollen eingeschränkt).
• Feingranulares Nachrichtentyp-System und pro Typ definierte Formatierung in der Plugin-Konfiguration.
• Entwickler-API zum Registrieren benutzerdefinierter Nachrichtentypen und Discord-Interaktionsbefehle über die bereitgestellte DiscordService-API.

🧩 Für wen es gedacht ist

• Serverbesitzer mit EssentialsX, die eine Chat-Synchronisation zwischen Discord ↔ Minecraft wollen.
• Teams, die private Team-Kanäle mit In-Game-Teammitgliedern verbinden möchten.
• Plugin-Entwickler, die einfache Discord-Interaktionen oder benutzerdefinierte Nachrichten-Hooks an Discord bereitstellen wollen.

🏗️ Beispielanwendungen

• Globalen Chat an einen eigenen Discord-Kanal weiterleiten und gleichzeitig Team-Discord-Nachrichten nur an das In-Game-Team senden.
• Verifizierten Discord-Rollen erlauben, konfigurierte Serverabfragen oder Befehle über Slash-Befehle auszuführen, ohne sie öffentlich zugänglich zu machen.
• Ein anderes Plugin strukturierte Benachrichtigungen an Discord senden lassen, indem ein benutzerdefinierter Nachrichtentyp über die EssentialsX-Discord-API registriert wird.

⌨️ Befehle

EssentialsX Discord stellt konfigurierbare Discord-seitige Slash-Befehle bereit (bei Discord registriert) statt der üblichen Minecraft-Chatbefehle. Diese Befehle (Beispiele in der offiziellen Doku) werden über Discord ausgeführt und können Konsolenbefehle ausführen, Spielern Nachrichten senden oder Spielerlisten anzeigen. Verfügbarkeit und erweiterte Funktionen werden über Rollen-/ID-Konfigurationen in der Plugin-Konfigurationsdatei gesteuert.

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade das EssentialsX-Discord-Modul-JAR herunter und lege es in deinem Serververzeichnis plugins/ neben dem EssentialsX-Kern-JAR ab.
• Starte den Server, um die Modulkonfiguration zu erzeugen, und stoppe den Server anschließend.
• Konfiguriere Bot-Token, Kanal-IDs, Nachrichtentypen und Befehls-Rolleneinstellungen in plugins/EssentialsDiscord/config.yml wie dokumentiert und starte dann neu.

📦 Abhängigkeiten

• EssentialsX (Kern) — das Modul läuft als Erweiterung der EssentialsX-Plugin-Suite.

🧠 Technische Hinweise

• Das Modul stellt eine Service-API (DiscordService) bereit, damit andere Plugins benutzerdefinierte Nachrichtentypen registrieren und Nachrichten in konfigurierte Discord-Kanäle senden können.
• Discord-seitige Befehle werden durch im Plugin konfigurierten Rollen/IDs gesteuert, nicht durch die üblichen Minecraft-Berechtigungsknoten.
• Die administrativ angelegte Konfiguration (Bot-Token, Kanal-IDs, Nachrichtenformatierung, Rollen-IDs für Befehle) erfolgt in der Konfigurationsdatei des Moduls, die beim ersten Start erstellt wird.

🤝 Wann dieses Plugin nützlich ist

Wenn du eine verwaltete, konfigurierbare Zwei-Wege-Kommunikation zwischen einer Discord-Community und einem auf EssentialsX basierenden Minecraft-Server brauchst — einschließlich rollenbeschränkter Discord-Befehle und Entwickler-Hooks — bietet EssentialsX Discord ein fokussiertes Modul, das Nachrichtenzuordnung und eine kleine API für Integrationen übernimmt.