Was sind Moderation Commands?
Chatlix erkennt Mod-Commands direkt im Twitch-Chat und führt sie über die Twitch-Helix-API aus. Du musst dafür keine extra Oberfläche öffnen — wenn ein Mod !ban irgendwer Trolling schreibt, wird der User gebannt und die Aktion landet im Audit-Log.
Wozu nicht einfach /ban von Twitch nutzen?
Twitchs eigenes /ban funktioniert weiterhin ganz normal. Der Unterschied: Chatlix-Commands schreiben jede Aktion zusätzlich als Datensatz in die Tabelle mod_actions (bei !warn zusätzlich in moderation_warnings). Damit hast du einen durchsuchbaren Audit-Trail im Dashboard unter Community aktivieren → Moderation → Audit — siehe Audit + Warning-Counter.
Verfügbare Moderation-Commands
Alle folgenden Commands verlangen im Code die Rolle mod (Twitch-Moderator oder Broadcaster). Der Parser ist case-insensitive, das erste Wort nach dem Command ist immer der Username (ein führendes @ wird automatisch entfernt), alles danach ist der Grund/Reason.
| Command | Was er macht | Details |
|---|---|---|
!ban USERNAME [Grund] | Permanent-Ban | |
!unban USERNAME | Ban aufheben | |
!timeout USERNAME [Dauer] [Grund] | Timeout | Ohne Angabe oder bei ungültigem Wert: 60 Sekunden. Dauer versteht Suffixe wie 30s, 5m, 2h, 1d, 1w. Twitch selbst deckelt bei 14 Tagen. |
!untimeout USERNAME | Timeout aufheben | |
!delete (als Reply) oder !delete USERNAME | Nachricht löschen | Als Reply auf eine Nachricht gepostet, löscht sie genau diese. Mit Username löscht der Bot die letzte im Cache vorhandene Nachricht dieses Users. |
!warn USERNAME [Grund] | Interne Verwarnung notieren (kein Twitch-Effekt) | Siehe Warning-Counter. |
!permit USERNAME [Sekunden] | Einmaliger Smart-Shield-Bypass für Links | Default 60s, einstellbar 5–3600s. Siehe Abschnitt weiter unten. |
Chat-Settings-Commands
| Command | Effekt |
|---|---|
!slow [Sekunden] | Slow-Mode an. Default 10s, Range 3–120s. |
!slowoff | Slow-Mode aus |
!emoteonly / !emoteonlyoff | Emote-Only-Mode an/aus |
!followers [Minuten] / !followersoff | Followers-Only-Mode an/aus. Default (ohne Angabe) laut Code fest 10 Minuten. Dauer versteht dieselben Suffixe wie !timeout (s/m/h/d/w), Range 0–129600 Minuten (90 Tage). |
!subscribers (Alias !subsonly) / !subscribersoff | Subscribers-Only-Mode an/aus |
Broadcaster-only Commands
Diese Commands funktionieren nur, wenn du selbst als Broadcaster schreibst — nicht für normale Mods:
!vip USERNAME/!unvip USERNAME— VIP-Status vergeben/entziehen!mod USERNAME/!unmod USERNAME— Mod-Status vergeben/entziehen (spiegelt sich 1:1 in Twitch)!clear— Chat komplett leeren, 60-Sekunden-Cooldown zwischen zwei Aufrufen
Was es NICHT gibt
Ein generisches !cancel, das die letzte Mod-Aktion (Ban/Timeout/Delete) rückgängig macht, existiert im Code nicht — auch wenn ältere Doku-Versionen das behauptet haben. !cancel ist tatsächlich ein Song-Request-Command und storniert einen Eintrag in der Song-Warteschlange, hat mit Moderation nichts zu tun. Willst du eine Mod-Aktion zurücknehmen, nutze gezielt !unban bzw. !untimeout.
Es gibt außerdem kein separates !help speziell für Moderation-Commands mit garantiert vollständiger Liste — verlass dich auf diese Wiki-Seite plus die Command-Antworten im Chat.
Wer darf was?
- Broadcaster und Twitch-Moderatoren (inklusive des Twitch-Badges „Lead Moderator", siehe Lead-Mod-Rolle) dürfen alle Moderation- und Chat-Settings-Commands.
- Es gibt keine Chatlix-eigene Zwischenstufe mit exklusiven Rechten — ein „Lead Mod" darf technisch exakt dasselbe wie jeder andere Mod, nicht mehr.
- VIPs dürfen keine Mod-Commands (nur lesend).
- Normale User werden ignoriert, ihre Commands laufen ins Leere.