Reaktionsrollen: Panels, Emojis und Fehlerbehebung

Mit Reaktionsrollen wählen Mitglieder ihre Rollen selbst: Du postest eine Panel-Nachricht mit Emoji-Zuordnungen. Wer mit einem Emoji reagiert, bekommt die zugehörige Rolle, und wer die Reaktion wieder entfernt, verliert sie.

Diese Seite ist die Referenz: wie Panels entstehen, welche Grenzen gelten und wie Kage Reaktionen verarbeitet. Eine kurze Anleitung findest du im Ratgeber Reaktionsrollen 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).
• Rollen in Discord: Lege die Rollen an, die per Reaktion vergeben werden sollen.
• Rollenreihenfolge: Kages Rolle muss in der Rollenliste über diesen Rollen stehen. Kage braucht außerdem das Recht Rollen verwalten (in der Standard-Einladung enthalten).
• Im Panel-Kanal: Kage braucht Nachrichten senden, Links einbetten und Reaktionen hinzufügen.

Ein Panel erstellen

Im Dashboard unter Reaktionsrollen füllst du „Neues Panel erstellen“ aus und klickst auf Panel erstellen & posten:

1. Wähle den Kanal, in dem das Panel stehen soll.
2. Gib einen Titel an. Ohne Titel verwendet Kage „Rollen wählen“.
3. Schreibe optional eine Beschreibung.
4. Füge unter „Emoji → Rolle“ mindestens eine Zuordnung hinzu: ein Emoji und eine Rolle.
5. Kage prüft die Angaben: Der Kanal und jede Rolle müssen existieren, jedes Emoji darf im Panel nur einmal vorkommen.
6. Kage postet eine Nachricht mit dem Titel, deiner Beschreibung und je einer Zeile „Emoji — @Rolle“ je Zuordnung und fügt selbst alle Reaktionen hinzu.

Wichtige Grenzen:

• Nur Standard-Emojis. Eigene Server-Emojis nimmt Discord für diese Funktion nicht an. Lehnt Discord ein Emoji ab, steht die Panel-Nachricht bereits im Kanal. Lösche sie dann in Discord von Hand und erstelle das Panel neu.
• Höchstens 20 Zuordnungen pro Panel, weil Discord höchstens 20 verschiedene Reaktionen pro Nachricht erlaubt.
• Höchstens 10 Panels pro Server. Neben der Panel-Liste zeigt das Dashboard außerdem, wie viele Panels dein Tarif vorsieht (Basic 3, Premium 25, Enterprise unbegrenzt).

Ein bestehendes Panel lässt sich nicht bearbeiten. Lösche es mit Löschen im Dashboard (das entfernt auch die Nachricht in Discord) und erstelle ein neues.

So verarbeitet Kage eine Reaktion

1. Kage beobachtet Reaktionen auf allen Nachrichten des Servers. Es reagiert nur auf Nachrichten, die als Panel gespeichert sind.
2. Reaktionen von Kage selbst und von anderen Bots werden ignoriert.
3. Ist „Reaktionsrollen aktiv“ aus, passiert nichts.
4. Passt das Emoji zu einer Zuordnung des Panels, vergibt Kage die zugehörige Rolle. Entfernt jemand die Reaktion, entzieht Kage die Rolle wieder.
5. Existiert die Rolle nicht mehr, überspringt Kage die Zuordnung.
6. Im Reiter Logs des Moduls erscheint jede Vergabe („Rolle … an … vergeben“) und jeder Entzug.

Kage kennt keinen Einzelwahl-Modus: Jede Reaktion vergibt ihre Rolle unabhängig von den anderen. Wer mehrere Emojis anklickt, bekommt mehrere Rollen. Das Panel funktioniert auch nach einem Neustart des Bots weiter.

Einstellungen im Überblick

Es gibt keine Slash-Befehle für Reaktionsrollen.

Ergebnis überprüfen

1. Panel: Prüfe, dass die Nachricht im Kanal steht und unter ihr alle Reaktionen vom Bot hinzugefügt wurden.
2. Praxistest: Reagiere mit einem zweiten Konto auf ein Emoji. Es sollte sofort die Rolle bekommen, und beim Entfernen der Reaktion wieder verlieren.
3. Protokoll: Der Reiter Logs im Modul zeigt Vergabe und Entzug.

Fehlerbehebung

Beim Reagieren passiert nichts

Prüfe, ob „Reaktionsrollen aktiv“ an ist und gespeichert wurde. Prüfe, ob das Panel noch in der Liste „Vorhandene Panels“ steht und ob die Nachricht in Discord nicht gelöscht wurde. Gelöschte Nachrichten bleiben in der Liste stehen, bis du das Panel im Dashboard löschst.

Die Rolle wird nicht vergeben

Meist ist es die Rollenreihenfolge: Kages Rolle muss über der Rolle stehen. Auch das Recht Rollen verwalten muss vorhanden sein. In Discord erscheint dazu keine Meldung, der Fehler steht nur im Betriebslog.

Das Panel lässt sich nicht erstellen

Prüfe die Meldung im Dashboard. Häufige Ursachen: kein Kanal gewählt, keine Zuordnung, ein Emoji doppelt, eine Rolle existiert nicht mehr, mehr als 20 Zuordnungen, bereits 10 Panels, oder Kage darf im Kanal nicht posten.

Ein Emoji wird abgelehnt

Es ist ein eigenes Server-Emoji oder ein Emoji, das Discord nicht kennt. Verwende ein Standard-Emoji. Das bereits gepostete Panel löschst du in Discord und erstellst es neu.

Mitglieder bekommen mehrere Rollen, obwohl nur eine gewollt ist

Es gibt keinen Einzelwahl-Modus. Teile die Rollen auf getrennte Panels auf und weise die Mitglieder darauf hin, nur ein Emoji zu wählen, oder nutze Rollen-Panels mit Buttons oder Auswahlmenüs.

Weiterführend

Mehr zu Rollenproblemen steht im Ratgeber Rollen-Fehlersuche. Wenn Neue ihre Rolle automatisch bekommen sollen: Auto-Rollen.