Command-Settings — was im Commands-Pane einzustellen ist¶
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: https://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:
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:
- Im Actions-Pane gewünschte Action öffnen
- Triggers-Tab →
+ Trigger→Twitch → Commands → Command Triggered - Im Dialog den eben angelegten Command auswählen
- 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
Anywhereaktiv → 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