DiscordSRV

Verbindet den Serverchat mit Discord – Spieler und Discord sehen eine Konversation.

← Plugins Aussehen und Chat Lizenz GPL-3.0-or-later Anleitung für DiscordSRV 1.28.x (Paper/Spigot)

Beim Autor herunterladen Quellcode 524 478 Download beim Autor autor Scarsz

Was macht das?

DiscordSRV verbindet einen Minecraft-Server mit Discord: Was im Spiel geschrieben wird, erscheint im Kanal auf Discord, und was dort geschrieben wird, sehen die Spieler im Spiel. Damit hört Discord auf, ein Nebenschauplatz zu sein, und wird zum zweiten Fenster des Servers.

Neben dem Chat kann es auch Ereignisse weiterleiten: Beitritt und Verlassen von Spielern, Erfolge, Tode, Serverstart und -stopp, Auflistung der Online-Spieler im Kanalnamen. Alle diese Texte sind in der Datei messages.yml, wo du jede Meldung auf Tschechisch umschreibst.

Der zweite große Teil ist die Verknüpfung von Konten: Ein Spieler schreibt im Spiel /discord link, erhält einen Code und schickt ihn dem Bot per privater Nachricht. Der Server weiß dann, welcher Discord zu welchem Spieler gehört — und kann entsprechend Rollen vergeben (etwa VIP auf Discord nach dem Rang im Spiel).

DiscordSRV braucht einen eigenen Bot. Du erstellst ihn im Discord Developer Portal, fügst seinen Token in die Konfiguration ein und lädst ihn auf deinen Server ein mit Berechtigungen zum Lesen und Schreiben von Nachrichten. Der Token ist ein Geheimnis — gib ihn niemals in ein öffentliches Repository oder in den Chat.

Am nützlichsten sind die Einrichtung der Kontoverknüpfung, die Weiterleitung von Ereignissen und Rollen nach Rang. Aktiviere dagegen niemals die Weiterleitung privater Nachrichten — Spieler würden aufhören, sich zu schreiben, wenn sie wüssten, dass ein öffentlicher Kanal es sieht.

Eine bekannte Erfahrung von tschechischen Servern: Nach der Installation sind die Meldungen auf Englisch (Erfolge, Verbindungen, Tode). Alle sind in messages.yml und lassen sich in kurzer Zeit übersetzen — die Spieler bemerken es, und der Server wirkt dadurch heimelig.

Installation

  1. Richte einen Bot ein: Erstelle auf discord.com/developers/applications eine Anwendung, darin den Bereich Bot, und kopiere den Token. Bewahre ihn sicher auf.
  2. Aktiviere in den Bot-Einstellungen beide Schalter für die Intents (Privileged Gateway Intents) — ohne sie sieht der Bot den Inhalt von Nachrichten nicht.
  3. Lade den Bot zu deinem Discord ein: Erstelle in OAuth2 einen Link mit Berechtigungen zum Lesen und Schreiben von Nachrichten und füge ihn mit dem Bot zum Server hinzu.
  4. Aktiviere in deinem Discord den Entwicklermodus (Einstellungen → Erweitert) und kopiere die Server-ID (Rechtsklick auf seinen Namen) und die Kanal-ID für den Chat.
  5. Lade DiscordSRV von modrinth.com/plugin/discordsrv oder von dev.bukkit.org herunter und lege die .jar in den Ordner plugins.
  6. Starte den Server neu und öffne plugins/DiscordSRV/config.yml — füge den Token, die Server-ID und die Kanal-ID für den Chat ein.
  7. Stelle ein, was weitergeleitet werden soll: den Chat aus dem Spiel, Nachrichten aus Discord, Ereignisse (Beitritte, Erfolge, Tode) und die Spielerliste in den Kanalnamen.
  8. Lade die Konfiguration erneut (/discordsrv reload) und schreibe etwas im Spiel — die Nachricht muss auf Discord erscheinen, und umgekehrt.
  9. Öffne plugins/DiscordSRV/messages.yml und übersetze die Meldungen ins Tschechische. Nach der Änderung führe /discordsrv reload.
    10 aus) Richte die Kontoverknüpfung ein: Im Spiel /discord link, schicke den Code dem Bot per Direktnachricht und überprüfe, dass er geantwortet hat.
  10. Wenn du Rollen nach dem Rang im Spiel möchtest, stelle in der Konfiguration ein, welche Gruppe aus LuckPerms welcher Rolle auf Discord entspricht.
  11. Überprüfe die Sicherungen: private Nachrichten (/msg) dürfen nicht nach Discord weitergeleitet werden. Entscheide das bewusst, nicht versehentlich.

Berechtigungen

Berechtigungen werden Spielern oder Gruppen erteilt — am häufigsten mit einem Befehl. /lp user <Spieler> permission set <Knoten> true (LuckPerms). Einen Knoten, der nicht in der Liste ist, kennt das Plugin nicht.

Berechtigungen Was ermöglicht
discordsrv.player Grundbefehle (/discord)
discordsrv.chat von Discord ins Spiel schreiben
discordsrv.link eigenes Konto verknüpfen (/discord link)
discordsrv.admin Plugin-Verwaltung (/discordsrv reload und weitere)
discordsrv.* absolut alles (nur Admin)

Befehle

Schreib es in den Chat auch mit Schrägstrichen. Wo ist <Spieler> oder <uzel>, ergänze deinen eigenen Wert ohne Klammern.

Befehl Was macht es?
/discord Hilfe und Verknüpfungsstatus
/discord link generiert einen Code zur Kontoverknüpfung (den Code sendest du dem Bot per privater Nachricht)
/discord unlink hebt die Kontoverknüpfung auf
/discord linked listet verknüpfte Konten auf
/discordsrv reload lädt die Konfiguration und Texte erneut (nach Änderung der messages.yml)
/discordsrv broadcast sendet eine Nachricht in die verknüpften Kanäle
/discordsrv status Verbindungsstatus des Bots
Auf Discord erfolgt die Verknüpfung per Befehl oder privater Nachricht an den Bot, je nach Servereinstellung

Einstellungen und häufige Fehler

Der Bot-Token ist ein Geheimnis. Wenn du ihn versehentlich veröffentlichst, gehe zum Developer Portal und lass den Token neu generieren (Regenerate) — andernfalls kann jeder deinen Bot steuern.
Aktiviere für den Bot beide Intents (Privileged Gateway Intents). Ohne sie werden Nachrichten von Discord nicht weitergeleitet und es sieht wie ein Plugin-Fehler aus.
Die Meldungen sind nach der Installation auf Englisch. Du findest sie in messages.yml und übersetzt sie — das ist der schnellste Weg, damit der Server heimelig wirkt.
Aktiviere niemals die Weiterleitung privater Nachrichten (/msg) an einen öffentlichen Kanal. Spieler müssen sicher sein, dass sie ohne Publikum schreiben können.
Die Auflistung der Online-Spieler im Kanalnamen ist schön, aber der Kanal wird wiederholt umbenannt und Discord begrenzt das. Einmal alle paar Minuten reicht.
Die Verknüpfung von Konten ist die Grundlage für Rangrollen: Ohne sie weiß Discord nicht, wer wer ist, und Rollen können nicht automatisch vergeben werden.
Wenn der Bot nicht antwortet, gehe die Reihenfolge durch: Token, Servereinladung, Kanal-ID, Rechte des Bots in diesem Kanal. Die meisten Probleme liegen in einem dieser vier Schritte.

Wer benutzt das?

Server aus unserer Liste, die dieses Plugin verwenden:

Verwendest du es auf deinem Server? Schreib uns und wir fügen ihn der Liste hinzu.

Ähnliche Plugins

TAB
Spielerliste, Name über dem Kopf und Textleiste – wer ist wer und was passiert.
SkinsRestorer
Gibt den Spielern ihren Skin zurück — auch auf einem Offline-Server, auf dem sie sonst ohne Kopf herumlaufen würden.

Woher stammt die Anleitung?

Die Anleitung ist unsere eigene und basiert auf der Dokumentation des Autors. Berechtigungen und Befehle beschreiben wir als Fakten, wir spekulieren nicht — wenn sich Plugin nach einem Update ändert, kann die Anleitung hinterherhinken. (Version DiscordSRV 1.28.x (Paper/Spigot)) Hast du einen Fehler gefunden? Schreib uns und wir werden es reparieren.

Lizenz: GPL-3.0-or-later. Die Datei wird bei uns nicht gehostet, sie wird beim Autor (Scarsz) heruntergeladen — so ist immer die aktuelle Version verfügbar.

Kopiert