Streamer.bot Grundlagen¶

Bevor du Commands baust musst du vier Begriffe auseinanderhalten. Wer das verwechselt klickt im falschen Pane.

Die vier Bausteine¶

Begriff	Was es ist	Wo im UI
Action	Container aus Sub-Actions die nacheinander laufen	Linkes Pane "Actions"
Sub-Action	Einzelschritt innerhalb einer Action (Send Message, If/Else, ...)	Rechtes Pane wenn Action ausgewählt
Trigger	Ereignis das die Action startet (Command, Follow, Reward, ...)	Innerhalb der Action ein Tab "Triggers"
Command	Chat-Eintrag wie `!clip` der einen `Command Triggered` Trigger feuert	Pane "Commands"

Workflow im Bild:

Chat-User tippt "!clip"
        │
        ▼
Command "!clip" matcht (Commands-Pane)
        │
        ▼
Trigger "Command Triggered" feuert in Action [Cmd] !clip
        │
        ▼
Action laeuft ihre Sub-Actions ab:
   1. Create Clip
   2. If/Else (Success?)
   3. Send Message mit %createClipUrl%

Warum Command und Action getrennt sind¶

Ein Command kann auf mehrere Sources hören (Twitch, YouTube, Kick) und feuert immer den gleichen Command Triggered Trigger. Die Action entscheidet was passiert. Du kannst auch eine Action ohne Command bauen (z.B. via Follow-Trigger) — dann läuft sie automatisch wenn jemand folgt.

Actions-Pane¶

Linke Seite oben → Tab Actions. Hier siehst du die Liste aller Actions. Rechtsklick auf eine Action zeigt:

Test Trigger — Action manuell ausführen (für Debugging)
Add Trigger — Trigger hinzufügen (Command Triggered, Follow, etc.)
Group — Action einer Gruppe zuweisen (Filter im Pane)
Random — wenn aktiviert wird nur EINE zufällige Sub-Action ausgeführt (siehe Random-Group Pattern)

Commands-Pane¶

Linke Seite oben → Tab Commands. Hier definierst du was der Chat tippen muss damit ein Trigger feuert. Wenn du im Commands-Pane einen neuen Command anlegst musst du im UI die zugehörige Action verknüpfen — die Verknüpfung passiert in der Action selbst: Triggers-Tab → Command Triggered → Command auswählen.

Sub-Actions hinzufügen¶

In der Action unten rechts: + Sub-Action. Es öffnet sich der Sub-Action-Picker mit Kategorien wie Twitch, Core, OBS Studio, YouTube. Du suchst dort den passenden Eintrag (z.B. Twitch → Chat → Send Message to Channel).

Tipp: das Such-Feld oben im Picker durchsucht alle Sub-Actions nach Namen. Wenn du den exakten Namen kennst tippst du ihn statt durch die Menüs zu klicken.

Sub-Action-Reihenfolge¶

Sub-Actions laufen von oben nach unten in der Action. Du kannst sie per Drag & Drop umsortieren. Zwei Spezial-Sub-Actions ändern den Flow:

Break (Core → Logic → Break) — bricht die Action sofort ab
If/Else → Then/Else Branches — Sub-Actions innerhalb von Then oder Else laufen nur wenn Bedingung passt

Sub-Action gruppieren¶

Mehrere Sub-Actions können zu einer Group zusammengefasst werden:

Sub-Actions markieren (Strg+Klick)
Rechtsklick → Group
Group bekommt einen Namen
Group kann per Rechtsklick → Random zur Zufalls-Auswahl umgewandelt werden

Group ohne Random = einfach optisches Zusammenfassen. Group mit Random = nur eine ihrer Sub-Actions wird ausgeführt.

Action testen ohne Chat¶

Action öffnen → rechts oben Button Test Trigger. Streamer.bot fragt nach Test-Argumenten (z.B. was soll %userName% sein) und führt dann die Action mit denen aus.

Logs sehen: unten Tab Logs. Log Sub-Action im Action-Flow gibt Debug-Output dort aus.

Wichtigste Triggers für Chat-Commands¶

Trigger	Wann er feuert
`Twitch → Command → Command Triggered` (üblich)	Wenn jemand einen registrierten Command tippt
`Twitch → Chat → Message`	Auf JEDE Chat-Nachricht (Vorsicht, viel Traffic)
`Twitch → Channel → Follow`	Neuer Follow
`Twitch → Channel Reward → Reward Redemption`	Channel-Point-Reward eingelöst
`Twitch → Subscriptions → Subscription`	Neue Sub
`Twitch → Chat → Cheer`	Bits gecheert

Für 99% der Chat-Commands brauchst du nur Command Triggered. Den fügst du in der Action-Triggers-Liste hinzu und verknüpfst ihn mit dem im Commands-Pane angelegten Command.

Naming-Konvention¶

Damit Actions-Pane übersichtlich bleibt:

[Cmd] !name für Chat-Commands (z.B. [Cmd] !clip)
[Reward] Name für Channel-Point-Rewards
[Event] Name für Follows/Subs/Raids
[Sys] Name für Helper-Actions die du intern aus anderen Actions aufrufst