Konzepte — Action, Sub-Action, Trigger, Command

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, Tab „Triggers”
Command	Chat-Eintrag wie `!clip`, der einen `Command Triggered`-Trigger feuert	Pane „Commands”

Flow im Bild

Chat-User tippt "!clip"
        │
        ▼
Command "!clip" matcht (Commands-Pane)
        │
        ▼
Trigger "Command Triggered" feuert in Action [Cmd] !clip
        │
        ▼
Action läuft 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 (Debugging)
Add Trigger — Trigger hinzufügen (Command Triggered, Follow, …)
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. Die Verknüpfung zur Action 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 ).

Sub-Action-Reihenfolge

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

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

Sub-Actions gruppieren

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

Sub-Actions markieren (Strg + Klick)
Rechtsklick → Group
Group benennen
Group kann per Rechtsklick → Random zur Zufalls-Auswahl werden

Group ohne Random = 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 die Action damit aus.

Logs sehen: unten Tab Logs. Eine 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-Points-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 der Actions-Pane übersichtlich bleibt:

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