Linked Roles einrichten

Linked Roles sind eine Discord-Funktion: Eine Rolle kann so eingestellt werden, dass sie nur vergeben wird, wenn bestimmte Anforderungen erfüllt sind. Diese Anforderungen stehen nicht in Discord selbst, sondern kommen aus einer Anwendung – hier aus dem Dashboard.

Der Ablauf: Ein Mitglied klickt in Discord auf Konto verbinden, wird zum Dashboard geleitet, meldet sich mit Discord an – und das Dashboard schreibt die Werte (z. B. Spielzeit, Level) in die Rollenverbindung des Kontos. Discord versteht daraufhin die Anforderungen und vergibt die Rolle.

Für jede Bot-Anwendung, die Linked Roles nutzen soll, müssen zwei URLs exakt so im Developer Portal stehen. Das Dashboard zeigt sie dir in der Linked-Roles-Verwaltung an; die Muster lauten:

Redirect-URL (OAuth2)

https://dash.modiq.fr/api/linked-roles/<Bot-ID>/callback – unter *OAuth2 → Redirects* eintragen. Discord lehnt den Verbindungsvorgang ab, wenn die URL nicht zeichengenau übereinstimmt.

Verification-URL

https://dash.modiq.fr/linked-roles/<Bot-ID> – wird von der Registrierung automatisch als role_connections_verification_url der Anwendung gesetzt und muss dort nicht von Hand eingetragen werden.

1. 1

   Metadaten-Felder anlegen

   Im Dashboard die Felder definieren, die als Anforderung dienen sollen – z. B. ein Zahlenfeld für Spielzeit. Jedes Feld hat einen Key, einen Typ (Zahl, Ja/Nein, Datum, Text) und eine Beschreibung, die in Discord sichtbar ist.

2. 2

   Registrieren

   Über Registrieren werden die Felder bei Discord hinterlegt und die Verification-URL gesetzt. Schlägt das fehl, meldet Discord den Grund – meist eine fehlende Redirect-URL oder ein ungültiger Token.

3. 3

   In Discord: Rolle → Verknüpfungen → Anforderung

   In den Servereinstellungen unter Rollen die gewünschte Rolle öffnen, den Reiter Verknüpfungen wählen und dort das Feld mit dem gewünschten Wert als Anforderung hinzufügen.

4. 4

   Verbinden lassen

   Mitglieder klicken in Discord auf Konto verbinden und landen auf der Verbindungsseite des Dashboards.

• „Diese App ist noch nicht vollständig eingerichtet“ – die Metadaten wurden noch nicht registriert.
• „Die Verbindung ist abgelaufen oder wurde manipuliert“ – der Vorgang wurde zu spät abgeschlossen oder in einem anderen Browser gestartet; einfach neu starten.
• „Der Server konnte nicht ermittelt werden“ – die Verbindung wurde nicht aus Discord heraus gestartet.
• Rolle kommt nicht an – die Anforderung ist nicht erfüllt, oder die Bot-Rolle steht nicht über der vergebenen Rolle.