Reaktions-Rollen
Rollen per Reaktion, Button oder Dropdown selbst verteilen lassen.
Reaktions-Rollen-Panels verbinden ein Emoji, einen Button oder eine Dropdown-Option mit einer Rolle. Der Bot postet (oder verknüpft) eine Nachricht; klickt ein Mitglied darauf, vergibt oder entfernt der Bot die zugehörige Rolle. Ein Panel kann eine neue Nachricht mit eigenem Embed sein oder an eine bestehende Nachricht angehängt werden. Alles arbeitet ereignisgesteuert, ohne eigene Befehle. (messageroles)
Bild folgt
Das Dashboard mit geöffnetem Tab „Reaktions-Rollen“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.
Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.
public/docs-assets/modules/messageroles.png · 1600x900 · dunkles Design
Panels anlegen
Ein Panel verbindet Kanal und Nachricht mit mindestens einer Zuordnung (Emoji, Button oder Option → Rolle). Du legst es in einem von zwei Modi an:
- Neue Nachricht
- Der Bot sendet eine neue Nachricht mit dem Panel. Du nutzt ein eigenes Embed (Titel, Beschreibung, Farbe, Bild, Thumbnail) oder ein gespeichertes Embed aus dem Embed-Modul.
- Existierende Nachricht
- Du gibst Kanal und Nachrichten-ID (oder einen Link) an und der Bot hängt sich an eine bereits vorhandene Nachricht.
Gespeichert werden die Panels als Teil der Server-Einstellungen in data/dashboardSettings.json unter dem Schlüssel messageRoles — pro Server bzw. bei Custom-Bots pro Bot und Server.
Panels bleiben nach dem Senden bestehen
Die Zuordnung wird nach Kanal und Nachrichten-ID erkannt. Verschiebt sich die Nachricht nicht und bleibt der Eintrag bestehen, funktioniert das Panel dauerhaft — auch nach einem Bot-Neustart.Reaktionstypen
- Reaktionen
- Der Bot legt unter die Nachricht für jede Zuordnung eine Emoji-Reaktion. Ein Klick vergibt die Rolle, ein entferntes Emoji nimmt sie wieder weg.
- Buttons
- Klickbare Buttons. Je Zuordnung wählst du Beschriftung (max. 80 Zeichen) und Farbe (Blurple, Grau, Grün, Rot). Ein Klick schaltet die Rolle an oder wieder aus.
- Dropdown
- Ein Auswahlmenü, das alle Rollen des Panels anbietet. Als Beschriftung dient der Rollenname (max. 100 Zeichen); ein Emoji ist optional.
Mit Nur eine Rolle hält ein Mitglied höchstens eine der angebotenen Rollen gleichzeitig: Beim Dropdown erlaubt das Menü nur eine Auswahl, bei Buttons nimmt der Bot die vorherige Rolle des Panels weg, und bei Reaktionen entfernt er zusätzlich die übrigen Reaktionen des Mitglieds an der Nachricht.
Wie die Rolle vergeben wird
Die Vergabe läuft ereignisgesteuert, nicht über einen Befehl: Der Bot reagiert auf die Reaktion, den Button oder das Dropdown, sucht das Panel über Kanal- und Nachrichten-ID und schaltet die Rolle um.
- Bei Reaktionen kommt die Bestätigung als Direktnachricht an das Mitglied. Sind DMs geschlossen, geschieht die Vergabe trotzdem — nur die Bestätigung entfällt.
- Bei Buttons und Dropdown ist die Bestätigung nur für das klickende Mitglied sichtbar.
- Ein entferntes Reaktions-Emoji nimmt die zugehörige Rolle wieder weg.
Befehle
/reaction-roleschannel title description rolesAdministratorErstelle ein Reaction Roles System mit Buttons
Einstellungen im Dashboard
| Einstellung | Typ | Bedeutung |
|---|---|---|
Modul Reaktions-Rollen aktivmessageRolesEnabled | Schalter | Schaltet das Modul Reaktions-Rollen ein oder aus. |
Modusmode | Text | Bestimmt, wie das Panel entsteht: Neue Nachricht (der Bot sendet Embed und Auswahl) oder Existierende Nachricht (Kanal und Nachricht-ID werden verknüpft). |
ReaktionstypreactionType | Text | Wie Mitglieder wählen: reactions (klassische Emoji-Reaktion), buttons (klickbare Buttons) oder dropdown (Auswahlmenü mit allen Rollen).Standard: reactions |
KanalchannelId | Kanal | Kanal, in dem das Panel gepostet oder gesucht wird. Zur Auswahl stehen Textkanäle. |
Nachricht-IDmessageId | Text | ID der bestehenden Nachricht (oder ein Link darauf). Nur im Modus Existierende Nachricht, dort sind nur Reaktionen möglich. |
Vorhandenes Embed nutzen (optional)embedId | Text | Verwendet ein gespeichertes Embed aus dem Embed-Modul statt der eigenen Titel-/Beschreibungsfelder. Ohne Auswahl gilt „Eigenes Embed“. |
Titeltitle | Text | Überschrift des eigenen Embeds. Maximal 256 Zeichen. |
Beschreibungdescription | Text | Beschreibung des eigenen Embeds. Maximal 4096 Zeichen. |
Farbecolor | Text | Farbe des eigenen Embeds (Discord-Standardfarbe oder eigener Hex-Wert). |
Bild-URLimage | Text | URL eines Bildes im Panel-Embed. |
Thumbnail-URLthumbnail | Text | URL eines kleinen Bildes im Panel-Embed. |
Label (optional)label | Text | Beschriftung des Panels, z. B. „Rollenauswahl“. Maximal 200 Zeichen. |
Nur eine RollesingleSelect | Schalter | Erlaubt nur eine Auswahl: Beim Dropdown eine statt mehrerer Rollen, bei Buttons entfernt ein anderer Button die vorherige Rolle, bei Reaktionen kann ein Mitglied nur eine Reaktion halten.Standard: Aus |
Emoji → Rollebindings | Text | Die Zuordnungen des Panels. Je nach Reaktionstyp ist der erste Wert ein Emoji, ein Button-Text oder eine Dropdown-Option und der zweite die vergebene Rolle. |
Button-Textbindings[].buttonLabel | Text | Beschriftung eines Buttons. Nur beim Reaktionstyp buttons. Maximal 80 Zeichen. |
Farbebindings[].buttonStyle | Text | Button-Farbe: 1 Blurple, 2 Grau, 3 Grün, 4 Rot (Discords Button-Stile). Nur beim Reaktionstyp buttons.Standard: 1 (Blurple) |
Eigene Bestätigungsnachricht beim Erhalten (optional)bindings[].message | Text | Nachricht, die dem Mitglied angezeigt wird, wenn es die Rolle erhält. Maximal 200 Zeichen. |
Stolperfallen
- Der Bot braucht die Berechtigung „Rollen verwalten“ und muss in der Rollenhierarchie über den vergebenen Rollen stehen. Sonst kann er sie nicht zuweisen.
- Discord erlaubt höchstens 25 Buttons (5 Reihen zu je 5) bzw. 25 Dropdown-Optionen pro Panel.
- Bei einer bestehenden Nachricht sind nur Emoji-Reaktionen möglich; Buttons und Dropdown benötigen eine vom Bot gesendete Nachricht.
- Mit „Nur eine Rolle“ kann ein Mitglied höchstens eine der angebotenen Rollen gleichzeitig halten.
Siehe auch