Role Panels: Rollen per Button oder Dropdown selbst wählen

Role Panels sind das moderne Selbstbedienungs-System für Rollen: Du postest eine Nachricht mit Buttons oder einem Dropdown, und Mitglieder wählen damit ihre Rollen selbst. Anders als bei den Reaktionsrollen gibt es eine Einzelwahl-Gruppe, ein Maximum an gleichzeitigen Rollen, befristete Rollen und eine Level-Anforderung pro Rolle.

Role Panels sind außerdem die Rollenauswahl im Onboarding. Eine kurze Anleitung findest du im Ratgeber Role Panels einrichten.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff). Die Befehle /rolepanel setzen dasselbe Recht voraus.
• Rollen in Discord: Lege die Rollen an, die Mitglieder wählen sollen.
• Rollenreihenfolge: Kages Rolle muss in der Rollenliste über diesen Rollen stehen. Kage braucht außerdem Rollen verwalten (in der Standard-Einladung enthalten).
• Im Panel-Kanal: Kage braucht Nachrichten senden und Links einbetten.
• Für Level-Anforderungen: Das Level-System sollte eingeschaltet sein (Ränge, Level und Belohnungen).

Ein Panel anlegen

Im Dashboard unter Role Panels klickst du auf + Panel hinzufügen und füllst es aus:

Dann gehst du in zwei Schritten vor:

1. Speichern sichert die Konfiguration. Ein Panel braucht dafür einen Kanal und mindestens eine Rollen-Option.
2. Panel posten postet die Nachricht in den Kanal. Später aktualisiert Panel aktualisieren dieselbe Nachricht, statt eine neue zu posten. Wurde sie gelöscht, postet Kage sie neu.

Die Nachricht zeigt Titel, Beschreibung und die Rollenliste mit Emoji. Hinter einer Rolle steht, falls gesetzt, „ab Level N“ und die Dauer in Stunden. Ein Hinweis in der Fußzeile nennt „Einzelwahl“ oder das Maximum.

Du kannst die Panels auch mit Befehlen verwalten (siehe unten). Die Panel-Anzahl hängt vom Tarif ab: Premium erlaubt bis zu 15 Panels, Enterprise bis zu 50. Bereits vorhandene Panels über der Grenze werden nicht gekürzt, nur weiteres Wachstum wird blockiert.

So arbeitet ein Panel

Buttons

• Ein Klick auf einen Button schaltet die Rolle um: Hat das Mitglied sie nicht, bekommt es sie, hat es sie, verliert es sie.
• Bei Einzelwahl entfernt Kage beim Vergeben die anderen Panel-Rollen des Mitglieds.
• Ist ein Maximum gesetzt (ohne Einzelwahl) und erreicht, lehnt Kage weitere Rollen ab und nennt das Maximum.
• Hat die Option eine Level-Anforderung und das Mitglied erreicht sie nicht, erscheint die Meldung, welches Level nötig ist.

Dropdown

• Das Mitglied wählt eine oder mehrere Rollen. Kage gleicht die Auswahl mit den aktuellen Rollen des Mitglieds ab: Neu gewählte Rollen werden vergeben, abgewählte entfernt.
• Bei Einzelwahl ist nur eine Auswahl möglich, sonst höchstens so viele wie das Maximum oder die Optionen erlauben.
• Eine Rolle, für die das Level fehlt, überspringt Kage hier ohne eigene Meldung; sie ist am Hinweis „ab Level N“ in der Auswahl erkennbar.

Befristete Rollen

Steht bei einer Option Std. temp., gilt die Rolle nur so viele Stunden (1 bis 8.760) und wird danach automatisch entzogen. Die Frist läuft über dieselbe Technik wie Temporäre Rollen. Entfernt das Mitglied die Rolle vorher selbst, löscht Kage die Frist.

Antworten

Kage antwortet nur dem Mitglied (ephemer): „➕“ mit den neuen Rollen und „➖“ mit den entfernten. Ändert sich nichts, sagt er das. Fehlt Kage das Recht für eine Rolle, erhält das Mitglied eine entsprechende Meldung. Jede Änderung steht im Reiter Logs.

Die Buttons und das Dropdown funktionieren auch nach einem Neustart des Bots. Ist das Modul ausgeschaltet oder das Panel nicht mehr in der Konfiguration, meldet Kage, dass das Panel nicht mehr aktiv ist.

Befehle

Die Gruppe /rolepanel ist nur mit Server verwalten nutzbar. Alle Antworten sehen nur du.

Mit der Befehls-Variante sind höchstens 20 Panels möglich.

Einstellungen im Überblick

Ergebnis überprüfen

1. Panel: Prüfe, dass die Nachricht im Kanal steht und die Buttons oder das Dropdown zeigt.
2. Testkonto: Klicke eine Rolle. Du bekommst „➕“ mit der Rolle, ein zweiter Klick entfernt sie.
3. Einzelwahl und Maximum: Prüfe, dass die anderen Rollen entfernt werden bzw. die Grenze greift.
4. Reiter Logs: Jede Änderung ist dort vermerkt.

Fehlerbehebung

Nichts passiert beim Klicken oder die Rolle kommt nicht

Meist ist es die Rollenreihenfolge: Kages Rolle muss über der Rolle stehen, und Kage braucht Rollen verwalten. Das Mitglied sieht dann die Meldung, dass Kage die Rolle nicht vergeben darf. Prüfe außerdem, ob die Rolle in Discord noch existiert.

„Panel ist nicht aktiv“

„Role Panels aktiv“ ist aus, oder das Panel wurde aus der Konfiguration entfernt. Aktiviere das Modul und poste das Panel erneut.

Das Panel lässt sich nicht posten

Wähle zuerst einen Kanal und mindestens eine Rollen-Option, speichere, und poste dann. Prüfe die Rechte von Kage im Kanal.

Eine Rolle wird nicht vergeben, obwohl man sie gewählt hat

Beim Dropdown fehlt eventuell das nötige Level, oder die Höchstzahl ist erreicht. Bei Buttons erscheint dafür eine Meldung.

Eine befristete Rolle bleibt bestehen

Kage konnte sie bei Ablauf nicht entfernen (Rollenreihenfolge oder Recht). Siehe Temporäre Rollen.

Weiterführend

Rollen beim Beitritt: Auto-Rollen. Rollen per Emoji: Reaktionsrollen. Geführter Einstieg: Onboarding.