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 ist dokumentiert was jedes Feld bedeutet — mit empfohlenen Standard-Werten für AzaCraft.
Doku-Quelle: docs.streamer.bot — Commands
Top-Bar: Name + Status
Abschnitt betitelt „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 | meist aktiviert |
| Group | Optionale Gruppierung im Pane | Themen-Gruppe wie AzaCraft Socials, Fun, Mod |
Commands (die Trigger-Texte)
Abschnitt betitelt „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!clipitTippt jemand !clip ODER !klippen ODER !clipit im Chat, läuft die Action.
Text Matching Mode
Abschnitt betitelt „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)
Abschnitt betitelt „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
Abschnitt betitelt „Options“| Option | Bedeutung | Empfehlung |
|---|---|---|
| Ignore Bot Account | Eigene Bot-Nachrichten ignorieren | aktiviert (gegen Loops) |
| Ignore Internal Messages | Von SB selbst gesendete Messages ignorieren | aktiviert |
| Persist per User Counter | %userCounter% über Restart erhalten | je nach Bedarf |
| Persist Counter | Globaler %counter% über Restart erhalten | je nach Bedarf |
| Case Sensitive | Groß/Klein muss exakt passen | meist deaktiviert |
Sources (Plattformen)
Abschnitt betitelt „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 dort auch streamst.
Cooldowns
Abschnitt betitelt „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 · 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
Abschnitt betitelt „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+ GroupsModerators, VIPs - Spam-User ausschließen →
Deny+ Userstrollguy123
Speichern und mit Action verknüpfen
Abschnitt betitelt „Speichern und mit Action verknüpfen“Nach Save ist der Command angelegt. Damit er etwas tut, musst du in der Action die Verknüpfung setzen:
- Im Actions-Pane die gewünschte Action öffnen
- Triggers-Tab →
+ Trigger→Twitch → Commands → Command Triggered - Im Dialog den eben angelegten Command auswählen
- Speichern
Ab jetzt feuert die Action, wenn der Command im Chat fällt.
Welche Variablen Command-Trigger liefern
Abschnitt betitelt „Welche Variablen Command-Trigger liefern“Sobald Command Triggered matcht, stehen in der Action diese Argumente bereit:
| Variable | Inhalt |
|---|---|
Argument %userName% Login des Senders, kleingeschrieben.
Variablen-Doku | Login des Senders (kleingeschrieben) |
Argument %user% Display Name des Senders — kann Caps und Akzente enthalten.
Variablen-Doku | 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 ) |
Argument %input0% Erstes Wort nach dem Command. Bei !iq @bob ist input0 = '@bob'.
Variablen-Doku , %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 · … |
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 Get User Info for Target.
Häufige Fallen
Abschnitt betitelt „Häufige Fallen“- Location
Anywhereaktiv — Command feuert auf zufällige Treffer in normalen Chat-Nachrichten. - Persist Counter vergessen — 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, Mods nicht.