Mod-Permissions Setup¶
Bevor du Mod-Commands baust: kläre wer was darf. Streamer.bot hat ein Permissions-System pro Command + ein User-Group-Konzept.
Permissions pro Command¶
Jeder Command im Commands-Pane hat zwei Felder:
| Feld | Bedeutung |
|---|---|
| Grant Type | Allow (nur die Genannten) oder Deny (alle außer Genannten) |
| Groups | User-Groups die erlaubt/blockiert sind |
| Users | Einzelne Logins (kommagetrennt) |
Broadcaster ist immer ausgenommen — egal welche Permissions. Du selbst kannst alle deine Mod-Commands triggern.
Eingebaute User-Groups¶
Streamer.bot bringt einige Twitch-Groups standardmäßig mit:
| Group | Wer drin ist |
|---|---|
Moderators |
Alle Mods deines Twitch-Channels |
VIPs |
Alle VIPs |
Subscribers |
Alle Subscriber |
Followers |
Alle Follower |
Diese werden von Twitch synchronisiert.
Eigene User-Groups anlegen¶
Linkes Pane → Tab Twitch → Sub-Tab User Groups → Rechtsklick → + Add Group.
Beispiele für Custom-Groups:
| Group | Use-Case |
|---|---|
Trusted Mods |
Mods denen du extra-Rechte gibst |
Banned from !so |
User die !so nicht nutzen dürfen |
Raid Heroes |
Leute die schon mal geraidet haben |
Hydrate Squad |
User die freiwillig den Hydrate-Reminder triggern dürfen |
User in Groups packen via Sub-Action Twitch → User Groups → Add User To Group. Oder manuell im UI.
Standard-Mod-Permission¶
Für alle Mod-Commands (!ban, !timeout, !chatmode, ...) das Permission-Standard-Pattern:
| Feld | Wert |
|---|---|
| Grant Type | Allow |
| Groups | Moderators |
| Users | (leer) |
So darf:
- Du selbst (Broadcaster) — immer erlaubt
- Alle Mods — über Group Moderators
- Sonst niemand
Erweiterte Permission: Mods + spezifische User¶
Beispiel: !ban dürfen nur Mods UND ein spezieller Co-Streamer:
| Feld | Wert |
|---|---|
| Grant Type | Allow |
| Groups | Moderators |
| Users | cohostuser123 |
Inverse Permission: !so für alle außer Trolls¶
Beispiel: !so dürfen alle, außer User in der Banned from !so Group:
| Feld | Wert |
|---|---|
| Grant Type | Deny |
| Groups | Banned from !so |
| Users | (leer) |
Permission-Checks zur Laufzeit¶
Wenn du in einer Action selbst prüfen willst (z.B. weil mehrere User-Typen unterschiedliche Pfade haben sollen):
[Cmd] !modonly-with-fallback
├── 1. If/Else: %isModerator% Equals true
│ ├── ... mod-stuff ...
│ └── Break
├── 2. If/Else: %isVip% Equals true
│ ├── ... vip-stuff ...
│ └── Break
└── 3. Send Message: "@%user% du darfst das nicht."
%isModerator%, %isVip%, %isSubscribed% sind bei Command Triggered automatisch verfügbar.
Group-Membership-Check via Sub-Action¶
Pfad: Twitch → User Groups → User In Group
| Feld | Wert |
|---|---|
| User Login | %userName% |
| Group | Trusted Mods |
Setzt %isInGroup% (bool) das du in If/Else prüfen kannst.
1. User In Group (Group = "Trusted Mods")
2. If/Else: %isInGroup% Equals true
├── Send Message: "@%user% bist trusted, los geht's"
└── ... action ...
3. Send Message: "@%user% nicht trusted."
Group-Management via Sub-Action¶
| Sub-Action | Was sie tut |
|---|---|
Twitch → User Groups → Add User To Group |
User in Group hinzufügen |
Twitch → User Groups → Remove User from Group |
User aus Group entfernen |
Core → Users → Clear Users From Group |
Group komplett leeren |
Use-Case: bei Raid-Empfang automatisch in Raid Heroes Group taggen (siehe Raid Welcome).
Mod-Commands in dieser Sektion¶
| Command | MD | Was er tut |
|---|---|---|
!ban @user [grund] |
ban.md | Permanent Ban |
!timeout @user 30 [grund] |
timeout.md | Temporärer Timeout |
!unban @user / !untimeout @user |
unban.md | Rückgängig machen |
!slowmode 30, !subonly, !emoteonly, !followonly |
chatmode.md | Chat-Modes setzen |
!title <text>, !game <name> (Mod-Set-Variante) |
set-title-game.md | Titel/Game ändern |
Häufige Fallen¶
- Permissions ohne
ModeratorsGroup leer lassen — wenn du Allow ohne Groups setzt, darf NIEMAND (außer Broadcaster). Doppelt prüfen - Cooldown auf Mod-Command — Mod ist NICHT von Cooldowns ausgenommen. Wenn du Mod-Command spammen können willst, Cooldown auf 0
- Custom-Groups syncen nicht — Custom-Groups sind nur in SB. Wenn du auf einem anderen PC Streamer.bot installierst, Groups manuell migrieren
Add User To Groupbei nicht-existierender Group — Group wird NICHT automatisch erstellt. Erst manuell im UI anlegen
Quellen¶
- User In Group: https://docs.streamer.bot/api/sub-actions/twitch/user-groups/user-in-group
- Add User To Group: https://docs.streamer.bot/api/sub-actions/twitch/user-groups/add-user-to-group
- Commands Guide (Permissions-Sektion): https://docs.streamer.bot/guide/core/commands