Linked Roles
Vergibt Discord-Rollen automatisch anhand von ModiQ-Daten — z. B. ab einem bestimmten Level oder mit aktivem Boost.
Linked Roles verbindet ModiQ-Daten mit den „Linked Roles“ von Discord. Du legst bis zu fünf Metadaten-Felder an (z. B. Level, XP, Coins, Mitglied seit, Booster), registrierst sie bei Discord und verknüpfst sie dort mit einer Rolle. Mitglieder, die ihr Konto über Server → Linked Roles verbinden, bekommen die Rolle automatisch, sobald ihre Daten die Bedingung erfüllen. Die Rolle selbst vergibt Discord, nicht der Bot. (linkedroles)
Bild folgt
Das Dashboard mit geöffnetem Tab „Linked Roles“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.
Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.
public/docs-assets/modules/linkedroles.png · 1600x900 · dunkles Design
Metadaten-Felder
- Key
- Interner Schlüssel des Feldes, a–z, 0–9 und
_(max. 50 Zeichen). - Anzeigename
- Name, den Discord für das Feld anzeigt.
- ModiQ-Datenquelle
- Welcher Wert übertragen wird: Level, XP gesamt, Voice-Coins, Coins (Bargeld), Coins (Bank), Mitglied seit, Discord-Konto erstellt am, Booster — sowie dynamisch „Hat Rolle …“.
- Vergleichstyp
- Discord-Vergleich: Zahl (≤, ≥, =, ≠), Zeitangabe (≤, ≥) oder Ja/Nein (=, ≠).
- Beschreibung
- Text, den der Nutzer in Discord sieht — Discord verlangt ihn.
Einrichtung & Synchronisierung
- „Felder speichern“ sichert die Felder, „Bei Discord registrieren“ meldet sie an und setzt die Verifizierungs-URL.
- „Jetzt synchronisieren“ überträgt die Daten verbundener Konten sofort.
- Die Metadaten werden zusätzlich automatisch alle 15 Minuten aktualisiert — nur bei tatsächlichen Änderungen.
- In Discord: Server-Einstellungen → Rollen → Rolle → „Links“ → „Anforderung hinzufügen“ und eines der registrierten Felder samt Bedingung wählen.
- Nutzer verbinden ihr Konto über Server → Linked Roles und erhalten die Rolle automatisch — Discord vergibt sie, nicht der Bot.
Für die App hinterlegst du im Tab „Einrichtung der App“ Application-ID (wird automatisch aus dem Bot-Token gelesen), Client Secret und Redirect-URL. Konfiguration und verbundene Konten liegen in data/linkedRoles.json, die Nutzer-Tokens in data/linkedRolesTokens.json.
Einstellungen im Dashboard
| Einstellung | Typ | Bedeutung |
|---|---|---|
Modul Linked Roles aktivlinkedRolesEnabled | Schalter | Schaltet das Modul ein oder aus. Beim Ausschalten sperrt der Bot die zugehörigen Funktionen (siehe FAQ „Befehl gesperrt“). |
Stolperfallen
- Linked Roles benötigt einen eigenen Bot (Custom Bot) mit hinterlegtem Client Secret; ohne ihn lassen sich die Felder nicht registrieren.
- Der Bot muss auf dem Server installiert sein, damit die Verifizierung funktioniert.
- Im Bereich „Verbundene Konten“ siehst du je Konto den Zeitpunkt der letzten Übertragung; „noch nicht übertragen“ heißt, dass der Bot dafür noch keine Daten gepusht hat.
Siehe auch