Temporäre Rollen: Rollen auf Zeit vergeben und automatisch entfernen

Mit temporären Rollen vergibst du eine Rolle für eine bestimmte Zeit, zum Beispiel 7 Tage Event-Teilnehmer oder 2 Stunden Zugang zu einem Kanal. Läuft die Zeit ab, entzieht Kage die Rolle automatisch. Du steuerst das über Befehle oder im Dashboard.

Eine kurze Anleitung findest du im Ratgeber Temporäre Rollen.

Voraussetzungen

• Rechte: Die Befehle /temprole sind nur mit dem Recht Rollen verwalten nutzbar. Im Dashboard brauchst du Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Rechte von Kage: Kage braucht Rollen verwalten, und seine Rolle muss in der Rollenliste über der zu vergebenden Rolle stehen.
• Läuft Kage? Die Ablaufprüfung arbeitet im Bot. Ist er zum Ablaufzeitpunkt offline, holt er die Entfernung nach, sobald er wieder läuft.

Befehle

Alle Antworten sehen nur du.

Die Dauer

Die Dauer besteht aus einer ganzen Zahl und einer Einheit: m Minuten, h Stunden, d Tage oder w Wochen, zum Beispiel 30m, 2h, 7d oder 1w. Andere Schreibweisen wie „1 Tag“ oder „90 Minuten und 5 Sekunden“ erkennt Kage nicht und lehnt sie mit einem Hinweis ab.

So läuft es ab

1. Vergeben: /temprole grant gibt die Rolle sofort und merkt sich Person, Rolle, Ablaufzeit, Grund und die vergebende Person. Gelingt das Vergeben nicht (zum Beispiel wegen der Rollenreihenfolge), meldet Kage das, und es wird nichts gespeichert.
2. Prüfen: Kage prüft jede Minute, welche Fristen abgelaufen sind.
3. Entfernen: Ist eine Frist abgelaufen, entzieht Kage die Rolle und vermerkt es im Reiter Logs des Moduls („Befristete Rolle … entfernt (abgelaufen)“).
4. Aufräumen: Kage löscht danach den Eintrag.

Verlängern und mehrfaches Vergeben

Vergibst du dieselbe Rolle derselben Person erneut, legt Kage einen weiteren Eintrag an. Solange noch ein anderer, nicht abgelaufener Eintrag existiert, bleibt die Rolle beim Ablauf eines Eintrags erhalten: Sie verschwindet erst, wenn der späteste Eintrag abläuft.

Vorzeitig entziehen

/temprole revoke löscht den Eintrag und entzieht die Rolle sofort, falls die Person sie noch trägt. Findet Kage keinen Eintrag, meldet er das, ohne etwas zu ändern.

Wenn die Person nicht mehr da ist

Hat die Person den Server verlassen, oder gibt es die Rolle nicht mehr, löscht Kage nur den Eintrag.

Wenn Kage die Rolle nicht entfernen kann

Fehlt Kage beim Ablauf das Recht oder steht seine Rolle zu niedrig, schreibt er eine Warnung ins Betriebslog und löscht den Eintrag trotzdem. Die Rolle bleibt dann bei der Person stehen, bis du sie von Hand entfernst. Prüfe in diesem Fall die Rollenreihenfolge.

Im Dashboard

Unter Temporäre Rollen vergibst du eine Rolle über die Suche nach einem Mitglied, die Rolle, die Dauer und einen optionalen Grund. Darunter listet das Dashboard die aktiven befristeten Rollen mit Person, Rolle, Ablauf und Grund. Mit Entziehen nimmst du eine Rolle vorzeitig zurück.

Zusammenspiel mit Role Panels

Role Panels können Rollen ebenfalls befristet vergeben (Feld „Std. temp.“). Kage nutzt dafür dieselbe Fristenverwaltung: Die Einträge erscheinen in der Liste der aktiven befristeten Rollen. Entfernt jemand die Rolle am Panel vorzeitig selbst, löscht Kage die Frist.

Einstellungen im Überblick

Temporäre Rollen haben keine eigenen Einstellungen. Es gibt nur die Befehle und die Dashboard-Seite.

Ergebnis überprüfen

1. Vergeben: /temprole grant mit einem Testkonto, einer Testrolle und 2m.
2. Liste: /temprole list zeigt die Rolle mit Ablaufzeit.
3. Warten: Nach spätestens etwa 3 Minuten ist die Rolle weg, und der Reiter Logs nennt die Entfernung.
4. Vorzeitig: Vergib erneut und entziehe mit /temprole revoke.

Fehlerbehebung

„Ungültige Dauer“

Verwende eine ganze Zahl mit der Einheit m, h, d oder w, zum Beispiel 2h. Leerzeichen zwischen Zahl und Einheit sind erlaubt, Kommazahlen und mehrere Einheiten nicht.

Die Rolle lässt sich nicht vergeben

Kage steht in der Rollenliste unter der Rolle, oder ihm fehlt Rollen verwalten. Kage meldet die fehlende Berechtigung in der Antwort.

Die Rolle bleibt nach Ablauf stehen

Kage konnte sie nicht entfernen (Rollenreihenfolge oder Recht), oder ein weiterer, späterer Eintrag für dieselbe Rolle und Person existiert noch. Prüfe /temprole list.

Die Frist ist zu kurz oder zu lang

Die Frist beginnt mit dem Vergeben. Vergibst du erneut, gilt die späteste Frist.

Weiterführend

Rollen per Button oder Dropdown: Role Panels. Rollen beim Beitritt: Auto-Rollen.