Erste Action: `!hello`

Dein erster Command. Wenn jemand im Chat !hello tippt, antwortet der Bot mit @User Hi! 👋. Klein, aber er deckt die drei Bausteine ab, die in jeder weiteren Action wiederkommen: Action anlegen, Sub-Action hinzufügen, Trigger verknüpfen.

Voraussetzungen

Was	Status
Streamer.bot v1.0.4+ läuft	Wenn nicht: Installation
Twitch-Broadcaster + Bot verbunden	Grüne Indikatoren in `Platforms → Twitch`
Bot ist Mod im eigenen Chat	`/mod NameDeinesBots` im Chat

Zeitaufwand: 5 Minuten.

Schritt 1: Action anlegen

Linkes Pane → Tab Actions → Rechtsklick in die leere Liste → Add Action.

Feld	Wert
Name	`[Cmd] !hello`
Enabled	aktiv
Group	(leer: kommt später wenn du viele Actions hast)

Klick Save. Die Action erscheint links in der Liste.

Schritt 2: Sub-Action hinzufügen

Action [Cmd] !hello ist links markiert → rechte Seite zeigt leeren Sub-Action-Container.

Unten rechts: Button + Sub-Action. Der Sub-Action-Picker öffnet sich mit Kategorien-Tree.

Send Message to Channel

Twitch Chat Send Message to Channel

Postet eine Nachricht in den eigenen Twitch-Chat.

Account	`Bot` Fällt auf Broadcaster zurück wenn Bot offline ist.
Message	`@%user% Hi!`
Use Bot	`aktiv`
Fallback to Broadcaster	`aktiv`

Im Picker entweder durch die Kategorien klicken (Twitch → Chat → Send Message to Channel) oder oben ins Such-Feld send message tippen. Doppelklick auf den Eintrag öffnet den Sub-Action-Editor.

Felder ausfüllen wie oben in der Tabelle, dann Save. Die Sub-Action erscheint im rechten Pane als Step 1.

Schritt 3: Command anlegen

Damit der Bot weiß, dass !hello deine Action triggern soll, brauchst du einen Command-Eintrag im Commands-Pane.

Linkes Pane → Tab Commands → Rechtsklick → Add Command.

Feld	Wert
Name	`!hello`
Command	`!hello`
Sources	Häkchen bei `Twitch`
Mode	`Anywhere in message` deaktivieren, `Starts with` aktivieren
Case Sensitive	deaktiviert
Ignore Internal Messages	aktiv (verhindert dass der Bot auf seine eigene Antwort reagiert)
Cooldown (Global)	`5` Sekunden
Cooldown (User)	`10` Sekunden

Klick Save. Der Command erscheint im Commands-Pane.

Schritt 4: Trigger in der Action verknüpfen

Zurück zur Action [Cmd] !hello. Rechtes Pane → Tab Triggers → + Add Trigger.

Feld	Wert
Trigger Type	`Twitch → Command → Command Triggered`
Command	`!hello` (Dropdown zeigt den eben angelegten Command)
Permission	`Everyone`

Klick Save. Der Trigger erscheint in der Triggers-Liste.

Damit ist alles verknüpft: Chat-Eintrag !hello → Command matcht → Trigger feuert in Action → Sub-Action postet Antwort.

Schritt 5: Im UI testen (ohne Chat)

Bevor du in den echten Chat tippst, teste die Action mit dem Test Trigger-Button:

Action [Cmd] !hello markiert.
Rechts oben: Button Test Trigger.
Streamer.bot fragt nach Test-Werten: bei %user% z.B. TestUser eintragen.
Run.

Im Logs-Pane (unten) erscheint:

[INFO] Action [Cmd] !hello triggered (test)
[INFO] Sub-Action 1: Send Message → "@TestUser Hi!"

Falls der Bot wirklich verbunden ist und das Häkchen Send Message in Test aktiv ist, sieht dein eigener Chat:

StreamerBotBot: @TestUser Hi!

So sieht's im Chat aus

Schritt 6: Im echten Chat testen

Öffne deinen Twitch-Chat (auf twitch.tv/<deinkanal> oder im Stream-Deck-Chat). Tippe:

!hello

Erwartetes Ergebnis:

StreamerBotBot: @DeinName Hi!

So sieht's im Chat aus

Falls nichts passiert: Springe zu Was tun wenn nichts passiert.

Action-Flow im Bild

Du tippst "!hello" im Chat
        │
        ▼
Command "!hello" matcht (Commands-Pane)
        │
        ▼
Trigger "Command Triggered" feuert in [Cmd] !hello
        │
        ▼
Sub-Action 1: Send Message → "@%user% Hi!"
        │
        ▼
Bot postet "@DeinName Hi!" im Chat

Was tun wenn nichts passiert

Symptom	Wahrscheinliche Ursache	Fix
Bot ignoriert den Command komplett	Trigger nicht verknüpft	In der Action: Tab `Triggers` → existiert ein `Command Triggered → !hello`?
Action feuert (Logs sagen “triggered”) aber kein Chat-Post	Bot-Account nicht verbunden oder nicht im Chat	`Platforms → Twitch → Bot` → grüner Indikator? `Connected to Chat: Yes`?
`Action triggered` fehlt im Log	Command nicht gespeichert oder Source-Häkchen für Twitch fehlt	Commands-Pane → `!hello` → `Sources: Twitch` aktiv?
Chat-Post enthält `%user%` als Text statt Namen	Variable nicht aufgelöst: falsches Encoding oder Tippfehler	Sub-Action öffnen, Message-Feld prüfen: muss exakt `%user%` sein (Prozent vor und nach)
Bot postet doppelt	Aktion ist sowohl mit `Command Triggered` als auch mit `Message`-Trigger verknüpft	Triggers-Tab: `Message`-Trigger löschen
Cooldown-Message statt Antwort	Cooldown noch aktiv	10 Sekunden warten, oder Cooldown in Commands-Pane temporär auf 0 setzen

Wenn nichts davon hilft: Logs-Pane (unten) öffnen, nach roten [ERROR]-Einträgen suchen. Mehr Patterns: FAQ.

Was du jetzt kannst

Mit diesem Setup hast du verstanden:

Action anlegen und Sub-Action hinzufügen
Command definieren mit Cooldown und Sources
Trigger in der Action mit Command verknüpfen
Test Trigger zum Debuggen ohne Chat
%user% als automatisch verfügbare Variable

Das ist das Grund-Skelett für jeden weiteren Command. Was sich von Command zu Command unterscheidet: andere Sub-Actions, mehr Schritte, If/Else-Branches, Variablen aus APIs. Aber Action + Command + Trigger bleibt immer gleich.

Nächste Schritte

Wenn du…	Lies als nächstes
die Bausteine tiefer verstehen willst	Konzepte
weitere Variablen kennen willst	Variablen-Referenz
Cooldowns, Permissions, Modes verstehen willst	Command-Settings
einen “richtigen” Command bauen willst	`!clip` als nächstes: gleiche Struktur, eine Sub-Action mehr
If/Else-Logik lernen willst	If/Else Pattern