Abwesenheit: Abwesenheiten melden, Liste im Kanal und Rolle auf Zeit

Mit dem Modul Abwesenheit tragen sich Mitglieder per Befehl für einen Zeitraum als abwesend ein, zum Beispiel für den Urlaub oder eine Prüfungsphase. Kage pflegt daraus eine übersichtliche Liste in einem Kanal deiner Wahl, entfernt jeden Eintrag zum Ende automatisch und vergibt auf Wunsch für die Dauer eine Abwesenheits-Rolle. Dein Team sieht auf einen Blick, wer wann wieder da ist.

Eine kurze Anleitung zum Einrichten findest du im Ratgeber Abwesenheit melden.

Voraussetzungen

• Modul aktiv: Das Modul Abwesenheit muss im Dashboard eingeschaltet sein. Ist es aus, antwortet /absence set mit dem Hinweis, dass die Funktion nicht aktiviert ist. Die Tarifzuordnung zeigt dir die Box „Zugehörige Kage-Module“ oben.
• Rechte im Dashboard: Einstellungen ändern darfst du mit Server verwalten (oder einem für dieses Modul freigegebenen Zugriff).
• Rechte von Kage im Listen-Kanal: Kage muss den Kanal sehen sowie Nachrichten senden und Links einbetten dürfen.
• Rechte von Kage für die Rolle: Nur wenn du eine Abwesenheits-Rolle einstellst, braucht Kage Rollen verwalten, und seine Rolle muss in der Rollenliste über der Abwesenheits-Rolle stehen.

Befehle

Alle Antworten sehen nur die Person, die den Befehl nutzt.

Für alle Mitglieder: /absence

Für Admins: /absence-admin

Die Admin-Befehle sind eine eigene Befehlsgruppe, die Discord standardmäßig nur Mitgliedern mit Server verwalten zeigt. Wer sie nutzen darf, kannst du in den Discord-Servereinstellungen unter Integrationen anpassen.

Den Zeitraum angeben

Das Ende (until)

Pflichtangabe. Zwei Schreibweisen sind erlaubt:

Andere Schreibweisen wie „nächste Woche“, „3 Tage“ oder Stunden erkennt Kage nicht und lehnt sie mit einem Hinweis ab.

Das Ende ist inklusive: Wer „bis 24.12.“ einträgt, ist den ganzen 24. noch abwesend. Der Eintrag läuft um 00:00 Uhr am Folgetag ab, gerechnet in der Zeitzone der Moduleinstellungen.

Der Start (start, optional)

Ohne Angabe beginnt die Abwesenheit sofort. Mit einem Datum (gleiche Schreibweisen wie oben) beginnt sie um 00:00 Uhr an diesem Tag. Liegt das Startdatum in der Vergangenheit, gilt „heute“. Eine Länge wie 7d wird ab dem Start gezählt.

Der Grund (reason, optional)

Freitext bis 300 Zeichen. Er steht in der Liste unter dem Namen.

Grenzen und Fehlermeldungen

So läuft es ab

1. Eintragen: /absence set speichert den Eintrag. Pro Person und Server gibt es genau einen Eintrag: Trägt sich jemand erneut ein, ersetzt der neue Eintrag den alten.
2. Beginnen: Liegt der Start in der Gegenwart, aktiviert Kage den Eintrag sofort und vergibt die Abwesenheits-Rolle, falls eingestellt. Liegt der Start in der Zukunft, steht der Eintrag in der Liste unter „Geplant“ und wird zum Start aktiviert.
3. Prüfen: Kage prüft jede Minute, welche Einträge beginnen und welche enden.
4. Beenden: Zum Ende nimmt Kage die Rolle weg, löscht den Eintrag und aktualisiert die Liste. War Kage zum Ablaufzeitpunkt offline, holt er das nach, sobald er wieder läuft.

Ändert jemand seinen Eintrag so, dass der neue Zeitraum erst später beginnt, nimmt Kage die bereits vergebene Rolle sofort weg. Beginnt der neue Zeitraum sofort, bleibt die Rolle unverändert.

Die Liste im Kanal

Ist im Dashboard ein Listen-Kanal gewählt, postet Kage dort eine Nachricht und hält sie aktuell:

• Aktuell abwesend (N): Wer jetzt abwesend ist, sortiert nach dem frühesten Ende. Zu jedem Eintrag stehen das Mitglied, das Enddatum, die Restzeit und, falls angegeben, der Grund.
• Geplant (N): Wer erst später abwesend ist, sortiert nach dem Start.
• Leer: Ist niemand eingetragen, steht dort „Gerade ist niemand abwesend.“

Gut zu wissen:

• Die Namen sind Erwähnungen, lösen aber keine Benachrichtigung aus.
• Sehr lange Listen kürzt Kage je Abschnitt und hängt „… und N weitere“ an.
• Die Sprache der Liste richtet sich nach der Serversprache in Discord (Deutsch bei deutscher Serversprache, sonst Englisch, auch wenn der Server keine Sprache gesetzt hat). Die Antworten auf Befehle richten sich nach der Sprache der jeweiligen Person.
• Löscht jemand die Nachricht, postet Kage sie beim nächsten Durchlauf neu. Wechselst du den Kanal, postet Kage im neuen Kanal und löscht die alte Nachricht.
• Kann Kage nicht posten (zum Beispiel wegen fehlender Rechte), versucht er es nach etwa 10 Minuten erneut. Mit /absence-admin refresh löst du es sofort aus.

Die Abwesenheits-Rolle

Die Rolle ist optional. Sie wird nur für die Dauer der Abwesenheit vergeben und beim Ende automatisch entzogen. Sinnvoll ist das zum Beispiel für eine eigene Farbe in der Mitgliederliste, für Kanalrechte oder für Automationen. Bei geplanten Einträgen bekommt die Person die Rolle erst zum Start.

• Merkt sich Kage eine Rolle für einen Eintrag, entzieht er genau diese Rolle, auch wenn du im Dashboard später eine andere einstellst.
• Kann Kage die Rolle nicht vergeben (Rollenreihenfolge oder fehlendes Recht), bleibt der Eintrag trotzdem aktiv, die Person bekommt nur keine Rolle. Kage schreibt dann eine Warnung ins Betriebslog.
• Ist die Person nicht mehr auf dem Server, geschieht nichts weiter, der Eintrag läuft normal ab.

Im Dashboard

Unter Abwesenheit stellst du das Modul ein und siehst, wer gerade eingetragen ist.

Darunter zeigt die Tabelle Aktuelle und geplante Abwesenheiten Mitglied, Zeitraum, Grund und Status („abwesend“ oder „geplant“, „Rolle vergeben“). Die Tabelle ist nur zum Ansehen: Eintragen, Beenden und Entfernen laufen über die Befehle, weil nur der Bot Rollen sauber vergeben und die Liste im Kanal pflegen kann. Namen zeigt das Dashboard für bis zu 50 Einträge, danach die Nutzer-ID.

Der Reiter Logs vermerkt, wenn sich jemand einträgt, wenn eine Abwesenheit beginnt und wenn sie endet. Der Reiter Statistik zählt diese Ereignisse pro Tag.

Abwesenheit oder AFK?

Der Befehl /afk markiert dich nur kurz als „nicht da“ und endet, sobald du wieder schreibst. Abwesenheit ist für geplante Zeiträume gedacht, die das Team sehen soll, und endet zu einem festen Datum.

Ergebnis überprüfen

1. Einrichten: Modul einschalten, einen Listen-Kanal wählen, speichern.
2. Eintragen: Mit einem Testkonto /absence set until:2d ausführen.
3. Liste: Binnen etwa einer Minute steht das Konto unter „Aktuell abwesend“, sofort nach dem Befehl in der Regel schon.
4. Beenden: /absence end ausführen. Der Eintrag verschwindet aus der Liste.
5. Admin-Ansicht: /absence-admin list zeigt dieselbe Übersicht privat.

Fehlerbehebung

Die Liste erscheint nicht

Im Dashboard ist kein Listen-Kanal gewählt, das Modul ist nicht eingeschaltet, oder Kage darf im Kanal nicht posten. Prüfe die Rechte und löse mit /absence-admin refresh aus. Die Antwort nennt, ob es geklappt hat.

„Die Abwesenheits-Funktion ist nicht aktiviert“

Das Modul ist auf dem Server ausgeschaltet. Schalte es im Dashboard ein.

Die Rolle wird nicht vergeben

Kage steht in der Rollenliste unter der Abwesenheits-Rolle, oder ihm fehlt Rollen verwalten. Der Eintrag selbst funktioniert trotzdem. Siehe auch Temporäre Rollen.

Die Rolle bleibt nach dem Ende stehen

Kage konnte sie nicht entziehen (Rollenreihenfolge oder Recht). Entferne sie von Hand und stelle die Rollenreihenfolge richtig.

Das Datum wird falsch gelesen

Gib das Jahr mit an (24.12.2026) oder nutze die Schreibweise 2026-12-24. Prüfe die eingestellte Zeitzone: Sie bestimmt, wann der Tag wechselt.

Ein Mitglied ist zu lange eingetragen

Entferne den Eintrag mit /absence-admin remove und senke bei Bedarf die Längste erlaubte Abwesenheit. Die Grenze gilt nur für neue Einträge.

Weiterführend

Rollen für eine begrenzte Zeit vergeben: Temporäre Rollen. Selbstbedienung per Button: Role Panels.