Funktionen

Rollen-Sync

Discord-Rollen und Ränge auf dem Minecraft-Server abgleichen, in beide Richtungen.

Der Rollen-Sync verbindet Discord-Rollen mit Rängen auf deinem Minecraft-Server. Bekommt jemand in Discord eine Rolle, führt der Server einen Befehl aus. Hat jemand im Spiel einen LuckPerms-Rang, vergibt der Bot die passende Discord-Rolle. Beides gilt nur für Spieler, die ihre Konten verknüpft haben.

Einrichten

Von Discord ins Spiel

Leg eine Regel für die Rolle an:

Öffne im Dashboard den Bereich „Rollen-Sync“.
Wähle unter „Regel für eine Rolle anlegen“ die Rolle, zum Beispiel @VIP.
Trag unter „Wenn die Rolle vergeben wird“ lp user {player} parent add vip ein.
Trag unter „Wenn die Rolle entfernt wird“ lp user {player} parent remove vip ein.
Prüf unter „Ausgeführter Befehl“ die Vorschau und klick auf „Speichern“.

/role-sync add role: @VIP on-grant: lp user {player} parent add vip on-revoke: lp user {player} parent remove vip

Erlaub die Befehle in der Konfiguration des Minecraft-Servers. Mit der Vorgabe whitelist lehnt er sie ab.

yaml

# Spigot, Paper, Folia: plugins/mc-sync/config.yml
commands:
  mode: allow
  allow: ["lp user * parent add", "lp user * parent remove"]

properties

# Fabric, Quilt, Forge, NeoForge: config/mc-sync.properties
commands.mode=allow
commands.allow=lp user * parent add,lp user * parent remove

Führ /mcsync reload aus. Auf Forge vor Minecraft 1.19 starte den Server neu.
Gib einem verknüpften Mitglied die Rolle. Der Befehl läuft auf jedem Minecraft-Server, der mit diesem Discord-Server verbunden ist.

Mehr zu commands.mode steht unter Befehle aus Discord.

Vom Spiel nach Discord

Dafür muss LuckPerms auf dem Minecraft-Server laufen. Diese Richtung gibt es nur im Dashboard.

Öffne im Dashboard „Rollen-Sync“ und geh zu „Ränge aus Minecraft“.
Wähle unter „Rang im Spiel“ den Rang und unter „Discord-Rolle“ die Rolle.
Klick auf „Hinzufügen“.
Sind mehrere Minecraft-Server verbunden, wähle unter „Welcher Server bestimmt die Ränge?“ einen aus.

Der Bot gleicht die Rollen ab, wenn ein Spieler den Server betritt und wenn sich sein Rang ändert. Er vergibt und entfernt nur Rollen, die hier eingetragen sind.

Einstellungen

Dashboard	`/role-sync add`	Wirkung
„Regel für eine Rolle anlegen“	`role`	Die Discord-Rolle. Je Rolle gibt es eine Regel.
„Wenn die Rolle vergeben wird“	`on-grant`	Befehl beim Erhalt der Rolle
„Wenn die Rolle entfernt wird“	`on-revoke`	Befehl beim Verlust der Rolle
„Rang im Spiel“ und „Discord-Rolle“		Welcher Rang welche Rolle bringt, höchstens 100 Zuordnungen
„Welcher Server bestimmt die Ränge?“		Nur dieser Server setzt und nimmt Rollen. Ohne Auswahl darf es jeder.

{player} wird durch den Minecraft-Namen ersetzt. Ohne Platzhalter läuft für alle derselbe Befehl.
Befehle ohne Schrägstrich, höchstens 300 Zeichen. Einer der beiden Befehle darf leer bleiben.
Die Befehle laufen mit Konsolenrechten.
/role-sync list zeigt alle Regeln, /role-sync remove role: @VIP löscht eine.

Probleme

Der Befehl läuft im Spiel nicht

Die Person muss auf diesem Discord-Server verknüpft sein. Sie prüft das mit /link show.
Der Minecraft-Server muss den Befehl unter commands.mode und commands.allow annehmen, siehe Einrichten.
Abgelehnte Befehle zeigt das Befehlsprotokoll. Den Kanal dafür legst du mit /notices channel purpose: commands fest.

Wer die Rolle schon hatte, bekommt den Rang nicht

Der Befehl läuft nur, wenn die Rolle vergeben oder entfernt wird. Wer sie schon vor dem Verknüpfen oder vor dem Anlegen der Regel hatte, bekommt nichts. Nimm die Rolle weg und gib sie neu.

Die Discord-Rolle wird nicht vergeben

Die Rolle des Bots muss in den Discord-Servereinstellungen über der Rolle stehen, die er vergeben soll. Sonst zeigt das Dashboard „Bot-Rolle zu niedrig“.
Der Spieler muss verknüpft sein und den Server betreten, nachdem die Zuordnung angelegt wurde.

Unter „Rang im Spiel“ steht nichts

Der Server hat noch keinen Rang gemeldet. Prüf, ob LuckPerms läuft und das Plugin aktuell ist (Download). Ränge erscheinen, sobald ein Spieler den Server betritt oder sich ein Rang ändert.

Die Rolle lässt sich nicht zuordnen

Du kannst nur Rollen zuordnen, die unter deiner höchsten Rolle stehen. Rollen mit Verwaltungsrechten wie Kicken, Bannen oder Rollen verwalten ordnet nur ein Administrator zu.

Die Rolle kommt und geht im Wechsel

Zwei Minecraft-Server melden für denselben Spieler verschiedene Ränge. Leg unter „Welcher Server bestimmt die Ränge?“ einen Server fest.

Hintergrund: Warum ein Befehl und keine Gruppe

Von Discord ins Spiel speichert der Bot nur den Befehl. Das funktioniert mit LuckPerms, PermissionsEx und jedem anderen Plugin, das Befehle hat.

Vom Spiel nach Discord braucht es eine Meldung, wenn sich ein Rang ändert. Die liefert nur LuckPerms. Der Server schickt dann alle Ränge des Spielers, nicht nur die Änderung. Geht eine Meldung verloren, gleicht die nächste aus.