Reaction-Roles
User wählen ihre Rollen per Klick selbst
Reaction-Roles erlauben es Usern, sich Rollen selbst zu geben oder zu entfernen — einfach per Button-Klick, Emoji-Reaktion oder Dropdown. Das ist ideal für Interessenrollen, Farbrollen, Ping-Optionen oder alles, was User freiwillig wählen sollen.
Konzepte: Parts und Messages
Eine Reaction-Role-Konfiguration besteht aus einem oder mehreren "Parts". Jeder Part ist eine Gruppe von Rollen-Optionen mit einer gemeinsamen Nachricht. Mehrere Parts können auf eine einzelne Discord-Nachricht veröffentlicht werden.
Eine veröffentlichte Message ist die Discord-Nachricht, die der Bot in einem Channel postet. Sie enthält die Buttons oder das Dropdown, mit denen User interagieren.
Interaktionstypen
| Typ | Max. Optionen | Beschreibung |
|---|---|---|
| Button | 25 (5 Reihen à 5) | Farbige Buttons (Primary/Secondary/Success/Danger), optionales Emoji, Label max. 80 Zeichen |
| Emoji-Reaktion | 20 | User reagiert mit Emoji auf die Nachricht — klassischer Reaction-Role-Stil |
| Dropdown | 25 | Dropdown-Menü mit Label und optionaler Beschreibung (max. 100 Zeichen) |
Modi: Standard vs. Invertiert
Standard: User klickt → Rolle wird vergeben. Klick erneut → Rolle wird entfernt.
Invertiert: User hat die Rolle standardmäßig. Klick → Rolle wird entfernt. Klick erneut → Rolle wird zurückgegeben.
Im Single-Modus (ein Dropdown oder eine Button-Gruppe) kann ein User immer nur eine Rolle gleichzeitig aus dieser Gruppe haben. Wählt er eine neue, wird die alte automatisch entfernt.
Im Multi-Modus können User beliebig viele Rollen aus der Gruppe kombinieren.
Embed-Editor
Jeder Part kann eine eigene Embed-Nachricht haben: Titel (max. 256 Zeichen), Beschreibung (max. 4.096 Zeichen), Farbe und bis zu 25 Felder. Der Bot veröffentlicht diesen Embed zusammen mit den Buttons/Emojis als eine Discord-Nachricht.
Publish-Flow
- Part erstellen: Interaktionstyp, Modus (Standard/Invertiert) und Rollen-Optionen konfigurieren
- Embed gestalten: Titel, Beschreibung, Farbe eintragen
- Ziel-Channel auswählen
- Auf "Veröffentlichen" klicken — der Bot postet die Nachricht
- Nach Änderungen: "Aktualisieren" klickt den Bot an, die bestehende Nachricht zu editieren (keine neue Nachricht)
Grenzen
| Einstellung | Limit |
|---|---|
| Parts pro Server | 40 |
| Buttons pro Nachricht | 25 (5×5 ActionRows) |
| Dropdown-Optionen | 25 |
| Emoji-Optionen | 20 |
| Button-Label | max. 80 Zeichen |
Häufige Fragen
- Was passiert mit bestehenden Reaction-Role-Nachrichten, wenn ich den Bot neu einlade?
- Die Konfiguration bleibt erhalten. Du musst bestehende Nachrichten aber manuell über "Aktualisieren" neu verknüpfen, damit der Bot wieder auf Klicks reagiert.
- Kann ich Reaction-Roles auf Nachrichten anwenden, die ich selbst geschrieben habe?
- Nein, der Bot kann nur Nachrichten verwalten, die er selbst gepostet hat. Veröffentliche immer über den Publish-Flow im Dashboard.
- Wie verhindere ich, dass User eine Rolle erhalten, für die sie nicht qualifiziert sind?
- Reaction-Roles haben kein Voraussetzungs-System. Wenn du Rollen nur für bestimmte User verfügbar machen willst, nutze Discord-Berechtigungen, um den Channel für unberechtigte User unsichtbar zu machen.