Discord-Rollen und Servergruppen synchronisieren
Automatische Vergabe einer Donator-Rolle in Discord nach LuckPerms-Gruppe und die umgekehrte Verknüpfung: Einrichtung, Überprüfung und häufige Fehler.
Aktualisiert am 13. August 2026
Rollenverknüpfung ist der wichtigste praktische Vorteil von DiscordSRV: Sie kaufen einen Rang und erhalten automatisch eine Discord-Rolle.
Einrichtung
plugins/DiscordSRV/synchronization.yml:
GroupRoleSynchronizationGroupsAndRolesToSync:
'vip': '123456789012345678'
'premium': '234567890123456789'
GroupRoleSynchronizationOneWay: false
GroupRoleSynchronizationCycleTime: 5
Links steht die LuckPerms-Gruppe, rechts die Discord-Rollen-ID (Rechtsklick auf die Rolle bei aktiviertem Entwicklermodus).
Kontoverknüpfung
/discord link
Der Spieler erhält einen Code und sendet ihn dem Bot per Direktnachricht. Ohne Verknüpfung ist keine Synchronisierung möglich.
Zwei-Wege-Modus
OneWay: false bedeutet, dass eine Discord-Rolle auch eine Gruppe auf dem Server vergibt. Praktisch, aber gefährlich: Wer in Discord Rollen verteilt, verteilt damit effektiv Ränge auf dem Server. Für Spendergruppen ist der Ein-Wege-Modus (Server → Discord) sicherer.
Bot-Berechtigungen
Die Rolle des Bots muss in der Discord-Rollenliste höher stehen als die Rollen, die er verwaltet, sonst kann er sie nicht zuweisen. Das ist die Ursache für 90 % der Fälle von „Synchronisierung funktioniert nicht".
Überprüfung
/discordsrv link Nick
/discordsrv debug
Im Log sehen Sie, welche Rollen der Bot zuzuweisen versucht und warum es fehlgeschlagen ist.
