Minecraft-Plugin DiscordSRV

🔌 Über DiscordSRV

DiscordSRV ist ein Minecraft-Plugin, das einen Minecraft-Server und einen Discord-Server miteinander verbindet. Es leitet den In-Game-Chat an Discord weiter (und Discord-Nachrichten ins Spiel), unterstützt die Kontoverknüpfung zwischen Minecraft- und Discord-Konten und bietet Synchronisierungshooks für Rollen/Gruppen sowie mehrere Serverereignisse.

🎯 Zweck

Der Hauptzweck von DiscordSRV besteht darin, eine zuverlässige, konfigurierbare Brücke zwischen einem Minecraft-Server und Discord bereitzustellen, damit Communities auf beiden Plattformen kommunizieren können, das Team informiert bleibt und Mitglieds-/Rolleninformationen bei Bedarf synchronisiert werden.

⚙️ Funktionen

• Bidirektionale Chat-Synchronisierung zwischen Minecraft- und Discord-Kanälen (pro Kanal konfigurierbar).
• Minecraft <-> Discord-Kontoverknüpfung für Spieler.
• Hooks zur Rollen-/Gruppensynchronisierung (Integrationspunkte für Berechtigungs-Plugins wie LuckPerms).
• Broadcast- und Team-Nachrichten von Minecraft an Discord.
• Befehle zum Verknüpfen, Prüfen des Verknüpfungsstatus und für Verwaltungsaktionen (reload, resync, debug).
• Mehrere Konfigurationsdateien für Kanalzuordnung, Sprache/Nachrichten, Synchronisierung und Sprachfunktionen.
• Open-Source-Code mit einem öffentlichen Issue-Tracker und Releases.

🧩 Für wen es ist

• Serverbesitzer und Admins, die den Community-Chat zwischen Minecraft und Discord vereinheitlichen möchten.
• Moderationsteams, die Serverereignisse in Discord sehen müssen.
• Netzwerke, die Berechtigungs-Plugins verwenden und Rollen- oder Gruppensynchronisierung mit Discord wünschen.

🏗️ Beispielanwendungen

• Globalen oder kanalbezogenen Minecraft-Chat an bestimmte Discord-Kanäle weiterleiten, damit Nutzer außerhalb des Servers Gespräche verfolgen können.
• Spielerkonten mit Discord-IDs verknüpfen, um Discord-Rollen zu vergeben oder Nutzer plattformübergreifend zu verifizieren.
• Server-Join-/Leave-/Console-Logs an einen Discord-Moderationskanal senden.

⌨️ Befehle

Spieler-Unterbefehle:

Team-Befehle:

(Veraltete Befehle im Zusammenhang mit dem alten Abonnementsystem sind in der Historie dokumentiert, aber aus dem aktuellen Betrieb entfernt.)

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die offizielle DiscordSRV .jar aus einer offiziellen Distribution herunter (Projektseite / Katalog / Releases).
• Lege die jar in den Ordner plugins/ deines Servers, für einen mit Bukkit/Spigot kompatiblen Server.
• Starte den Server neu und prüfe die Konsolenlogs, um zu bestätigen, dass DiscordSRV geladen wurde.
• Schließe die Erstkonfiguration ab (Bot-Token, Kanalzuordnungen, Verknüpfungsoptionen) mit den erzeugten Konfigurationsdateien.

📦 Konfigurationsdateien

DiscordSRV verwendet mehrere Konfigurationsdateien; bestätigte Dateinamen sind:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Bearbeite die passenden Dateien, um das Discord-Bot-Token, die Kanalzuordnungen und die Synchronisierungseinstellungen festzulegen. Einige Funktionen (Rollen-/Gruppensynchronisierung, Sprachintegration) erfordern zusätzliche Konfiguration.

🧠 Technische Hinweise

• Quellcode und Releases werden in einem öffentlichen Repository gepflegt.
• Das Projekt wird unter GPL-3.0 veröffentlicht.
• Bestätigte optionale Integrationen sind LuckPerms (Contexts/Gruppensynchronisierung) und PlaceholderAPI (Platzhalter).
• Befehle und Berechtigungen sind in der offiziellen Dokumentation beschrieben; administrative Aktionen wie resync und reload existieren und können Operator-Rechte erfordern.

🤝 Wann dieses Plugin nützlich ist

Wenn du einen konsistenten, konfigurierbaren Zwei-Wege-Chat und eine Kontoverknüpfung zwischen einem Minecraft-Server und einer Discord-Community brauchst, bietet DiscordSRV die Brücke, Integrations-Hooks und Konfigurationsdateien, um diese Funktionen zu betreiben und sich dabei in gängige Server-Plugins einzubinden.