Moderation: Befehle, Verwarnungen, Eskalation und Mod-Log
Wie die /mod-Befehle von Kage funktionieren: Kick, Ban, Timeout, Verwarnungen mit Eskalation, Notizen, Purge, Slowmode, Kanal sperren und Mod-Log – mit Rechten und Fehlerbehebung.
Zuletzt fachlich geprüft: 14. Oktober 2026
Die Moderation von Kage besteht aus Slash-Befehlen der Gruppe /mod. Sie funktionieren immer, auch wenn du im Dashboard nichts eingerichtet hast. Im Dashboard legst du nur fest, ob und wohin die Aktionen zusätzlich protokolliert werden (Mod-Log) und ob Kage bei einer bestimmten Anzahl Verwarnungen automatisch eine Strafe verhängt.
Jede Aktion wird außerdem als Fall gespeichert. So entsteht pro Mitglied ein Verlauf, den du mit /mod history abrufst. Eine kurze Anleitung findest du im Ratgeber Moderation einrichten und im Ratgeber Mod-Log.
Voraussetzungen
- Rechte der Moderatoren: Jeder Befehl prüft das Recht, das er braucht (siehe Tabelle). Die Gruppe
/modist standardmäßig nur für Mitglieder mit dem Recht Mitglieder kicken sichtbar. Unter *Servereinstellungen → Integrationen* kannst du das in Discord anpassen. - Rechte von Kage: Kage braucht dieselben Rechte (Kick, Ban, Mitglieder-Timeout, Nachrichten verwalten, Kanäle verwalten). Sie sind in der Standard-Einladung enthalten.
- Rollenreihenfolge: Kages Rolle muss in der Rollenliste über den Mitgliedern stehen, die du bestrafen willst.
- Für das Mod-Log: Kage braucht im Log-Kanal die Rechte Nachrichten senden und Links einbetten.
Die Befehle
| Befehl | Nötiges Recht | Wirkung |
|---|---|---|
/mod kick | Mitglieder kicken | Wirft ein Mitglied vom Server (es kann wieder beitreten). |
/mod ban | Mitglieder bannen | Bannt ein Mitglied. Optional werden Nachrichten der letzten 0 bis 7 Tage gelöscht (Standard 0). |
/mod softban | Mitglieder bannen | Bannt und entbannt sofort wieder, um Nachrichten zu löschen (0 bis 7 Tage, Standard 1), ohne dauerhaften Bann. |
/mod unban | Mitglieder bannen | Hebt einen Bann auf. Du gibst die Discord-Nutzer-ID an. |
/mod timeout | Mitglieder im Timeout | Setzt ein Mitglied für 1 bis 40.320 Minuten (28 Tage) in den Timeout. |
/mod timeout-clear | Mitglieder im Timeout | Hebt einen laufenden Timeout auf. |
/mod warn | Mitglieder im Timeout | Verwarnt ein Mitglied. Optional mit Beweis (Link oder Text). |
/mod history | Mitglieder im Timeout | Zeigt den vollständigen Verlauf eines Mitglieds, bis zu 25 Einträge. |
/mod case-remove | Mitglieder im Timeout | Entfernt einen einzelnen Fall anhand seiner Nummer. |
/mod note-add | Mitglieder im Timeout | Legt eine interne Notiz an, die nur Moderatoren sehen. |
/mod notes | Mitglieder im Timeout | Zeigt alle Notizen zu einem Mitglied. |
/mod note-remove | Mitglieder im Timeout | Entfernt eine Notiz anhand ihrer Nummer. |
/mod purge | Nachrichten verwalten | Löscht die letzten 1 bis 100 Nachrichten im aktuellen Textkanal, optional nur von einem Mitglied. |
/mod slowmode | Kanäle verwalten | Stellt den Slowmode eines Kanals ein (0 bis 21.600 Sekunden, 0 = aus). |
/mod lock | Kanäle verwalten | Sperrt einen Kanal: @everyone darf dort nicht mehr schreiben. |
/mod unlock | Kanäle verwalten | Hebt die Sperre wieder auf. |
Alle Antworten sehen nur du selbst (ephemer), außer bei lock und unlock: Dort antwortet Kage im Kanal sichtbar. Gibst du keinen Grund an, zeigt Kage in Antworten und Mod-Log den Platzhalter „Kein Grund angegeben“.
Wichtig zu Rollen und Rechten
- Vor Kick, Ban, Softban und Timeout prüft Kage, ob seine eigene höchste Rolle über der höchsten Rolle des Ziels steht. Ist das nicht der Fall, lehnt er die Aktion mit einem Hinweis ab. Die Rolle der ausführenden Person vergleicht Kage dabei nicht mit der des Ziels.
/mod purgebraucht für Kage zusätzlich Nachrichtenverlauf anzeigen im Kanal. Fehlt es, meldet Kage das, statt still zu scheitern.locksetzt bei @everyone das Recht „Nachrichten senden“ auf *verweigert*.unlocksetzt es wieder auf *neutral*, nicht auf *erlaubt*. Rollen mit eigenen Überschreibungen im Kanal sind davon nicht betroffen.
Fälle und Verlauf
Jede Aktion legt einen Fall mit Nummer, Typ, Moderator, Grund und Zeitpunkt an:
| Typ im Verlauf | Entsteht durch |
|---|---|
| Verwarnung | /mod warn |
| Kick | /mod kick |
| Ban | /mod ban |
| Softban | /mod softban |
| Entbannung | /mod unban |
| Timeout (mit Dauer) | /mod timeout |
| Timeout aufgehoben | /mod timeout-clear |
Fälle sind unveränderlich. Einen falschen Eintrag entfernst du mit /mod case-remove und der Fallnummer aus /mod history, bearbeiten kannst du ihn nicht. Interne Notizen funktionieren genauso: anlegen, anzeigen, entfernen. Alle Aktionen erscheinen auch im Reiter Logs des Moduls.
Automatische Eskalation
Mit Eskalationsregeln lässt Kage bei einer bestimmten Anzahl Verwarnungen automatisch eine Strafe folgen.
- Du legst im Dashboard bis zu 10 Regeln an: *Bei [Zahl] Verwarnungen:* Timeout, Kicken oder Bannen. Bei Timeout gibst du die Minuten an (1 bis 40.320, Standard 60).
- Pro Verwarnungszahl ist nur eine Regel erlaubt.
- Nach jedem
/mod warnzählt Kage die Verwarnungen des Mitglieds (nur Verwarnungen, keine Kicks oder Bans). Entspricht die Zahl genau einer Regel, führt Kage die Aktion aus. - Weil die Zahl genau passen muss, löst eine weitere Verwarnung die Regel nicht erneut aus. Entfernst du aber Fälle und das Mitglied erreicht die Zahl später noch einmal, greift die Regel wieder.
- Kage führt die Aktion nur aus, wenn er das nötige Recht hat und seine Rolle über dem Mitglied steht. Sonst passiert nichts, und es erscheint auch keine Meldung in Discord.
- Die Aktion erscheint im Mod-Log, mit Kage als Moderator.
Die Eskalation wird nur durch /mod warn ausgelöst. Die Regeln gelten unabhängig vom Schalter „Moderationsaktionen loggen“; der Schalter entscheidet nur über das Mod-Log.
Das Mod-Log
Im Dashboard unter Moderation schaltest du Moderationsaktionen loggen ein und wählst einen Log-Kanal. Empfohlen ist ein privater Kanal, den nur das Mod-Team sieht. Kage postet dann für diese Aktionen ein Embed mit Mitglied, Moderator und Grund:
- Kick, Ban, Softban, Timeout, Verwarnung
- Purge (mit Anzahl und Kanal), Kanal sperren, Kanal entsperren
- Automatische Eskalationen
Nicht im Mod-Log erscheinen Entbannungen, aufgehobene Timeouts, entfernte Fälle und Notizen. Sie stehen aber im Verlauf und im Reiter Logs. Das Mod-Log ist getrennt vom Audit-Log, das allgemeine Serveraktivität protokolliert.
Einstellungen im Überblick
| Dashboard-Feld | Bedeutung | Standard |
|---|---|---|
| Moderationsaktionen loggen | Schaltet das Mod-Log ein. Die Befehle selbst funktionieren immer. | aus |
| Log-Kanal | Kanal für die Mod-Log-Embeds | keiner |
| Automatische Eskalation | Bis zu 10 Regeln: Verwarnungszahl, Aktion, bei Timeout Minuten | keine |
Ergebnis überprüfen
- Befehl testen: Führe mit einem Testkonto
/mod warnaus. Die Antwort nennt die Fallnummer und die Gesamtzahl der Verwarnungen. - Verlauf:
/mod historyzeigt den Eintrag mit Nummer, Typ, Datum und Moderator. - Mod-Log: Im Log-Kanal erscheint das Embed.
- Eskalation: Verwarne ein Testkonto so oft, bis die Zahl einer Regel entspricht.
Fehlerbehebung
Die Befehle /mod sind nicht sichtbar
Du brauchst mindestens das Recht Mitglieder kicken, um die Gruppe zu sehen. Prüfe unter *Servereinstellungen → Integrationen*, ob der Befehl für deine Rolle eingeschränkt ist.
Kage lehnt Kick, Ban oder Timeout ab
Meist steht die Rolle des Mitglieds über oder auf gleicher Höhe wie Kages Rolle. Ziehe Kages Rolle in der Rollenliste nach oben. Prüfe außerdem, ob Kage das nötige Recht hat. Administratoren und der Serverbesitzer lassen sich nie per Timeout stummschalten.
/mod purge meldet fehlende Rechte
Kage braucht im Kanal Nachrichten verwalten und Nachrichtenverlauf anzeigen. Der Befehl funktioniert außerdem nur in Textkanälen.
Im Mod-Log erscheint nichts
Prüfe, ob „Moderationsaktionen loggen“ an ist und ein Log-Kanal gewählt und gespeichert wurde. Prüfe die Rechte von Kage im Kanal. Entbannungen und aufgehobene Timeouts werden dort nie gepostet.
Die Eskalation löst nicht aus
Die Verwarnungszahl muss genau einer Regel entsprechen. Gezählt werden nur Verwarnungen (/mod warn), nicht Kicks oder Bans. Prüfe außerdem Kages Rechte und Rolle. Entfernte Fälle senken die Zahl.
Ein Fall lässt sich nicht bearbeiten
Fälle sind unveränderlich. Entferne ihn mit /mod case-remove und lege bei Bedarf einen neuen an.
Weiterführend
Allgemeine Serveraktivität protokolliert das Audit-Log. Regelmäßiges Aufräumen übernimmt Auto Purge. Automatische Maßnahmen gegen Spam und Raids beschreiben Anti-Spam und Anti-Raid.
Zugehörige Kage-Module
- ModerationIn Basic enthalten
- Moderation Cases
Weiterlesen
Noch Fragen? Frag Kage AIKI
Beschreibe dein Anliegen – Kage AI sucht die passende Anleitung heraus und nennt dir die Quellen.
Kage auf deinem Server ausprobieren
Melde dich mit Discord an, lade den Bot ein und richte die Module im Dashboard ein. Der Basic-Tarif ist dauerhaft kostenlos.