Auto-Rollen: Einstellungen, Ablauf und Fehlerbehebung

Mit Auto-Rollen bekommt jedes neue Mitglied beim Beitritt sofort eine oder mehrere Rollen, ohne dass jemand etwas tun muss. Typische Beispiele sind eine „Mitglied“-Rolle oder eine Rolle, die den Zugang zu den Standardkanälen freischaltet.

Diese Seite ist die Referenz: Einstellungen, genauer Ablauf und Fehlerursachen. Eine kurze Anleitung findest du im Ratgeber Auto-Rollen 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 vergeben werden sollen.
• Rollenreihenfolge: Kages Rolle muss in der Rollenliste über allen zu vergebenden Rollen stehen.
• Recht Rollen verwalten: Kage braucht es. Es ist in den Rechten der Standard-Einladung enthalten.

So läuft die Vergabe ab

1. Ein Mitglied tritt dem Server bei.
2. Ist das Modul ausgeschaltet oder keine Rolle gewählt, passiert nichts.
3. Ist das Mitglied ein Bot-Konto und die Option „Auch für Bot-Accounts vergeben“ aus, passiert ebenfalls nichts.
4. Kage sucht die gewählten Rollen. Eine Rolle, die es nicht mehr gibt, wird übersprungen.
5. Kage vergibt alle gefundenen Rollen in einem Schritt. Ist auch nur eine davon nicht vergebbar, etwa weil sie über Kages Rolle steht, schlägt der ganze Schritt fehl, und das Mitglied bekommt keine der Rollen.
6. Bei Erfolg erscheint im Reiter Logs des Moduls ein Eintrag „N Rolle(n) an Name vergeben“, und die Statistik zählt mit.

Auto-Rollen wirken nur auf neue Mitglieder. Wer schon auf dem Server ist, bekommt die Rollen nicht nachträglich. Es gibt keine Slash-Befehle für dieses Modul.

Einstellungen im Überblick

Du findest sie im Dashboard unter Auto-Rollen.

Die Auswahlliste zeigt keine @everyone-Rolle und keine von Discord verwalteten Rollen (zum Beispiel Rollen von Bots und Integrationen). Rollen über Kages höchster Rolle lassen sich auswählen, scheitern aber bei der Vergabe. Das Dashboard weist darauf hin.

Zusammenspiel mit anderen Modulen

• Verifizierung: Beide laufen beim Beitritt unabhängig voneinander. Kage kann also gleichzeitig eine Auto-Rolle und die Unverified-Rolle vergeben. Stelle sicher, dass die Auto-Rollen keine Rechte geben, die vor der Verifizierung noch gesperrt sein sollen: Verifizierung.
• Willkommensnachricht und weitere Beitritts-Module laufen nacheinander und stören sich nicht.

Ergebnis überprüfen

1. Einstellungen: Prüfe, dass „Auto-Rollen aktiv“ an ist und die gewünschten Rollen gewählt und gespeichert sind.
2. Praxistest: Tritt mit einem zweiten Konto bei. Es sollte sofort die gewählten Rollen tragen.
3. Protokoll: Der Reiter Logs im Modul zeigt jede erfolgreiche Vergabe.

Fehlerbehebung

Neue Mitglieder bekommen keine Rolle

Prüfe, ob „Auto-Rollen aktiv“ an ist und mindestens eine Rolle gewählt und gespeichert wurde. Prüfe die Rollenreihenfolge: Kages Rolle muss über jeder gewählten Rolle stehen. Ist nur eine Rolle zu hoch, bekommt das Mitglied gar keine. In Discord erscheint dazu keine Meldung, der Fehler steht nur im Betriebslog.

Nur manche Mitglieder bekommen die Rollen

Bots bekommen sie nur mit der Option „Auch für Bot-Accounts vergeben“. Mitglieder, die schon vor der Einrichtung auf dem Server waren, bekommen sie nicht nachträglich.

Eine gewählte Rolle wurde gelöscht

Kage überspringt gelöschte Rollen und vergibt die übrigen. Wähle die Rolle im Dashboard ab und speichere.

Das Mitglied hat die Rolle bekommen und wieder verloren

Ein anderes Modul oder ein anderer Bot entfernt die Rolle. Prüfe in Discord im Server-Protokoll, wer sie entfernt hat. Mit Auto-Rollen allein verliert niemand eine Rolle.

Weiterführend

Mehr zur Rollenreihenfolge und zu typischen Fehlern steht im Ratgeber Rollen-Fehlersuche. Wenn Mitglieder ihre Rolle selbst wählen sollen: Reaktionsrollen.