!ban

~5 Min

Was du lernst

• Permanent-Ban mit optionaler Reason aus %rawInput%
• Target-Validation und Fehler-Handling für Mod-Commands
• Ban-Bestätigung im Chat posten

Voraussetzungen

• Set Argument Fallback
• If/Else Pattern
• Send Message Pattern

!ban

Fortgeschritten

Permanent-Ban via Chat. Strippt das @, baut Reason aus dem Rest, fängt fehlende Targets ab.

Patterns

Set Argument If/Else Ban User Send Message

Steps

8

Cooldown

5s/User

Cooldown

0sglobal

Zugriff

Mods

Voraussetzung

Mod-Permissions in den Command-Settings nötig: siehe Permissions-Setup. Ohne Grant Type = Allow + Group Moderators kann jeder bannen.

Strippt das @ aus %input0%, baut den Reason aus dem Rest, prüft auf Fehlschlag und postet eine Erfolgs-Meldung. Twitch setzt nach dem Ban %banResult% Argument %banResult% bool: true wenn Twitch den Ban akzeptiert hat. Variablen-Doku , %bannedUser% Argument %bannedUser% Display-Name des gebannten Users. Variablen-Doku und %bannedUserName% Argument %bannedUserName% Login des gebannten Users. Variablen-Doku .

Action: [Cmd] !ban

1

Set Argument: Target säubern

Core ›Arguments ›Set Argument

Strippt das @ aus %input0% falls vorhanden.

Variable Name	targetLogin
Value	$replace(%input0%, @, )$
Auto Type	aktiv

2

If/Else: Kein Target

Core ›Logic ›If/Else

Then-Branch wenn kein Target angegeben wurde.

Input	%targetLogin%
Operation	Is Null or Empty
Auto Type	aktiv

3

Then

Send Message: Hilfe-Text

Twitch ›Chat ›Send Message to Channel

Im Then-Branch von Sub-Action 2.

Message	@%user% nutze !ban @username [grund]
Send using bot account	aktiv

4

Then

Break

Core ›Logic ›Break

Im Then-Branch von Sub-Action 2: beendet die Action.

5

Set Argument: Reason

Core ›Arguments ›Set Argument

Strippt das Target aus %rawInput%. Rest ist der Reason.

Variable Name	banReason
Value	$replace(%rawInput%, %input0%, )$

6

If/Else: Default-Reason

Core ›Logic ›If/Else

Wenn kein Reason übergeben wurde, setzen wir einen Default.

Input	%banReason%
Operation	Is Null or Empty

6a

Then

Set Argument: Default-Reason

Core ›Arguments ›Set Argument

Im Then-Branch von Sub-Action 6.

Variable Name	banReason
Value	via !ban command von %userName%

7

Ban User

Twitch ›Moderation ›Ban User

Setzt %banResult%, %bannedUser%, %bannedUserName%, %bannedUserId%.

User Login	%targetLogin%
Reason	%banReason%

8

If/Else: Fehlgeschlagen

Core ›Logic ›If/Else

Then-Branch wenn der Ban nicht durchging.

Input	%banResult%
Operation	Equals
Value	false

8a

Then

Send Message: Fehler

Twitch ›Chat ›Send Message to Channel

Im Then-Branch von Sub-Action 8.

Message	@%user% Ban hat nicht geklappt. User existiert nicht oder ist schon gebannt.

8b

Then

Break

Core ›Logic ›Break

Im Then-Branch von Sub-Action 8.

9

Send Message: Erfolg

Twitch ›Chat ›Send Message to Channel

Wird nur erreicht wenn Ban + Success-Check durchgelassen haben.

Message	🔨 @%bannedUser% wurde gebannt. Reason: %banReason%
Send using bot account	aktiv

A AzaBot: 🔨 @troll wurde gebannt. Reason: Spammer

↑ So sieht's im Chat aus

Action-Tree

1. 1 Set Argument: targetLogin = $replace(%input0%, @, )$
2. 2 If/Else: %targetLogin% Is Null or Empty
   1. Then 3 Send Message: Hilfe-Text
   2. Then 4 Break
3. 5 Set Argument: banReason = $replace(%rawInput%, %input0%, )$
4. 6 If/Else: %banReason% Is Null or Empty
   1. Then 6a Set Argument: banReason = "via !ban command von %userName%"
5. 7 Ban User (Login %targetLogin%, Reason %banReason%)
6. 8 If/Else: %banResult% Equals false
   1. Then 8a Send Message: Fehler-Text
   2. Then 8b Break
7. 9 Send Message: "🔨 @%bannedUser% wurde gebannt..."

Command-Einstellungen

Feld	Wert
Name	!ban. Permanent Ban
Group	AzaCraft Mod
Commands	!ban
Location	Start
Sources	Twitch Message
Global Cooldown	0
User Cooldown	5
Grant Type	Allow
Groups	Moderators

Verwendungsbeispiele

Chat	Wer	Resultat
!ban @troll Spammer	Mod	Troll gebannt, Reason: „Spammer“
!ban troll mehr Worte zum Reason	Mod	Reason: „mehr Worte zum Reason“
!ban @troll	Mod	Default-Reason wird gesetzt
!ban	Mod	Hilfe-Text
!ban @troll	Normaler User	Permission blockt: keine Reaktion

Edge-Cases

• Eigene Mod-Rolle verlieren: wer Mod ist und gebannt wird, verliert Mod beim Ban. Bei Timeout wird sie automatisch wiederhergestellt.
• Selbst-Ban: !ban @<broadcaster> akzeptiert Twitch und sperrt dich aus. Filter via %targetLogin% Equals (Ignore Case) %broadcastUserName% + Break im Then-Branch.
• Bot bannt sich selbst: wenn der Bot Mod-Rechte hat und gebannt wird, ist er offline. Gleicher Filter, mit Bot-Login.

Erweiterungs-Ideen

• Audit-Log: Core > File I/O > Write To File, Mode Append, Content [%timestamp%] %userName% bannte %targetLogin%: %banReason%.
• Discord-Notification: Integrations > Discord > Basic Webhook mit dem Mod-Channel-Webhook.
• Selbst-Schutz: Im Then-Branch von Sub-Action 2 zusätzlich targetLogin Equals broadcastUserName checken und blocken.

Verwandt

• !unbanGegenstück: Ban aufheben.
• !timeoutTemporäre Sperre statt Perma-Ban.
• Permissions SetupMod-Rechte korrekt einrichten.

Streamer.bot Import

Import-String folgt

Die Action ist 1:1 nach Anleitung oben nachbaubar.

Quellen

• Ban User
• Send Message