Command-Settings erklärt

~6 Min

Was du lernst

• Was jedes Feld im Command-Konfig-Dialog bewirkt
• Welche Cooldowns und Permissions für welchen Command-Typ sinnvoll sind
• Welche Variablen ein Command-Trigger setzt (rawInput, input0..N, counter, userType)

Voraussetzungen

• Konzepte

Wenn du im linken Pane auf den Tab Commands klickst und unten + Command drückst, öffnet sich der Command-Konfig-Dialog. Hier dokumentiert was jedes Feld bedeutet, mit empfohlenen Standard-Werten für AzaCraft.

Doku-Quelle: docs.streamer.bot/guide/core/commands

Top-Bar: Name + Status

Feld	Bedeutung	Empfehlung
Name	Freier Label-Text für die Liste	Sprechender Name wie !clip (Twitch Clip erstellen)
Enabled	Toggle ob Command aktiv ist	aktiviert
Include	Soll Command in Get Commands Sub-Action gelistet werden	meistens aktiviert
Group	Optionale Gruppierung im Pane	Themen-Gruppe wie AzaCraft Socials, Fun, Mod

Commands (die Trigger-Texte)

Feld	Bedeutung
Commands	Liste der Chat-Strings die den Command auslösen, einer pro Zeile

Beispiel für Aliase:

!clip
!klippen
!clipit

Tippt jemand !clip ODER !klippen ODER !clipit im Chat, läuft die Action.

Text Matching Mode

Mode	Wann verwenden
Basic	Standard, prüft auf wörtliche Übereinstimmung mit den Command-Strings
Regex	Pattern Matching mit Capture-Groups (z.B. ^!give (\d+) (\w+)$)

Für 95% der Commands Basic.

Location (nur bei Basic)

Location	Match-Verhalten
Start	Nachricht muss MIT einem Alias beginnen (!clip irgendwas matcht !clip)
Exact	Nachricht muss EXAKT einem Alias sein (!clip matcht, !clip xy nicht)
Anywhere	Alias kann irgendwo in der Nachricht stehen

Standard: Start. Exact nur wenn der Command keine Argumente nimmt und du False-Positives vermeiden willst. Anywhere ist gefährlich (Bot reagiert auf jede Nachricht die “!clip” enthält).

Options

Option	Bedeutung	Empfehlung
Ignore Bot Account	Eigene Bot-Nachrichten ignorieren	aktiviert (gegen Loops)
Ignore Internal Messages	Von Streamer.bot selbst gesendete Messages ignorieren	aktiviert
Persist per User Counter	Per-User-Counter (%userCounter%) über Restart erhalten	je nach Bedarf
Persist Counter	Globaler Counter (%counter%) über Restart erhalten	je nach Bedarf
Case Sensitive	Groß/Klein muss exakt passen	meistens deaktiviert

Sources (Plattformen)

Multi-Select. Welche Quelle den Command triggern darf:

• Twitch Message: normaler Twitch-Chat
• YouTube Message: YouTube Live-Chat
• Twitch Whisper: Direktnachrichten an den Bot
• Twitch Subscription Message: Resub-Message-Text
• Twitch Re-subscription Message: Resub-Continue-Text

Standard für AzaCraft: nur Twitch Message. YouTube nur dazu wenn du auch dort streamst.

Cooldowns

Feld	Was es macht
Global Cooldown (s)	Mindestabstand für ALLE Nutzer. Erst nach Ablauf kann der nächste den Command nutzen
User Cooldown (s)	Mindestabstand pro User. Bob muss warten bevor er !clip wieder tippen darf, Alice kann sofort

Beide auf 0 = deaktiviert. Broadcaster ist immer von Cooldowns ausgenommen.

Empfehlungen pro Command-Typ:

Command-Typ	User CD	Global CD
Spam-anfällig (!clip)	30	5
Lustig/Fun (!iq, !rose)	30	0
Info (!discord, !socials)	60	30
Moderativ (!so)	0	0

Permissions

Grant Type	Wirkung
Allow	Nur die angegebenen Gruppen/User dürfen ausführen
Deny	Alle dürfen außer den angegebenen

Felder leer lassen = alle Plattform-User. Broadcaster ist immer ausgenommen.

Eingaben:

• Groups: User-Groups die du in Streamer.bot definiert hast (z.B. “VIP”, “Mods”)
• Users: einzelne Logins (kommagetrennt)

Beispiele:

• Mod-Command !so → Allow + Groups Moderators, VIPs
• Spam-User ausschließen → Deny + Users trollguy123

Speichern und mit Action verknüpfen

Nach Save ist der Command angelegt. Damit er was tut musst du in der Action die Verknüpfung setzen:

1. Im Actions-Pane gewünschte Action öffnen
2. Triggers-Tab → + Trigger → Twitch → Commands → Command Triggered
3. Im Dialog den eben angelegten Command auswählen
4. Save

Ab jetzt feuert die Action wenn der Command im Chat fällt.

Was Variablen die Command-Trigger liefern

Sobald Command Triggered matcht stehen in der Action diese Variablen bereit:

Variable	Inhalt
%userName%	Login des Senders (kleingeschrieben)
%user%	Display Name
%userId%	Twitch User-ID
%userType%	”broadcaster”, “moderator”, “vip”, “subscriber” oder leer
%message%	Komplette Chat-Nachricht inkl. Command
%rawInput%	Nachricht OHNE den Command-Trigger (alles nach !clip )
%input0%, %input1%, …	Einzelne Wörter ab Position 0 nach dem Command
%inputEscaped0%	URL-/Quote-escaped Version
%counter%	Wie oft der Command global aufgerufen wurde
%userCounter%	Wie oft der Sender den Command aufgerufen hat
%commandId%	GUID des Commands
%commandSource%	”twitch”, “youtube” etc.

Für !cmd @bob hallo ergibt das:

• %rawInput% = @bob hallo
• %input0% = @bob
• %input1% = hallo
• %userName% = (der Sender, NICHT bob)

Wenn du bob ohne @ willst → siehe patterns/06-get-user-info-target.md.

Häufige Fallen

• Location Anywhere aktiv → Command feuert auf zufällige Treffer in normalen Chat-Nachrichten
• Persist Counter vergessen und nach Restart sind alle Counter weg
• Sources falsch: Command auf YouTube aktiviert, Twitch nicht → nichts passiert auf Twitch
• Cooldown auf Mod-Action: du wartest auf deinen eigenen Command. Broadcaster ist exempt, aber Mods nicht

Verwandt

• Variablen-ReferenzAlle Variablen die Streamer.bot bereitstellt.
• Sub-Action-PfadeWie du Sub-Actions im Picker findest.
• Permissions-SetupUser-Groups, VIPs, Mods anlegen.