Erste Automation bauen

Erste Automation bauen

Wir bauen jetzt eine Automation, die etwas tut, das eine einfache Reaction nicht kann: „Bei jedem 50. Cheer ein Konfetti-Overlay und eine Chat-Bot-Ansage."

Voraussetzungen

• Twitch verknüpft, EventSub grün.
• Ein Konfetti-Overlay-Template existiert (/dashboard/overlays/templates).
• Twitch-Bot ist im Channel und kann Chat-Nachrichten senden.

Schritt 1 — Counter anlegen

Wir brauchen einen Counter, der jeden Cheer zählt.

1. /dashboard/automations/counters öffnen.
2. « Neuer Counter ».
3. Name: total_cheers.
4. Reset-Verhalten: « Pro Stream resetten » (oder « nie resetten », je nach Geschmack — wir nehmen für dieses Beispiel pro Stream).
5. Speichern.

Schritt 2 — Automation anlegen

1. /dashboard/automations → « Neue Automation ».
2. Name: Konfetti alle 50 Cheers.
3. Trigger: Twitch-Event → Bits / Cheer.
4. Conditions — wir wollen erstmal nichts filtern: leer lassen. Der Counter macht die Magie.
5. Actions — wir bauen drei Schritte:
   • Action 1: Counter inkrementieren → total_cheers um 1.
   • Action 2: If-Then (Condition: total_cheers % 50 == 0).
     • Dann:
       • Overlay → « Konfetti » für 4 Sekunden.
       • Chat-Nachricht → 🎉 {user} hat den {total_cheers}. Cheer ausgelöst!.
6. Speichern.

Wichtig: Im Editor referenzierst du den Counter direkt — {total_cheers} als Platzhalter in Text und Conditions wird zur Laufzeit durch den aktuellen Wert ersetzt.

Schritt 3 — Testen

Geh in der Automation auf « Test ». Du kannst einen Mock-Event setzen (z. B. Cheer mit 500 Bits) und das Verhalten vor Live-Gang prüfen. Das ist ein Dry-Run — der Counter wird im Test-Modus nicht dauerhaft hochgezählt (Toggle im Test-Dialog kontrollierbar).

Schritt 4 — Live

Automation auf enabled lassen, los geht's. In /dashboard/automations/runs siehst du jeden Lauf in Echtzeit: Trigger-Event, durchlaufene Conditions, ausgeführte Actions, Dauer, Status (success / failed / skipped_cooldown).

Bei jedem 50., 100., 150. Cheer feuern dann Overlay und Chat-Ansage.

Anderes Beispiel — Stream-Online-Begrüßung

Noch ein typischer Use-Case: beim Stream-Start eine Sequenz fahren.

1. Trigger: Twitch-Event → Stream Online.
2. Conditions: keine.
3. Actions:
   • OBS → Szenenwechsel zu Intro.
   • Delay 5 s.
   • OBS → Szenenwechsel zu Hauptszene.
   • Chat-Nachricht → Stream ist live! Viel Spaß euch allen..
   • Webhook → POST an deinen Discord-Webhook (Body: {"content": "Stream ist live!"}).
   • Variable setzen → stream_started_at = aktueller Zeitstempel.

Damit hast du Intro-Sequenz, Chat-Hinweis, Discord-Push und einen Zeitstempel, den andere Automations später lesen können (z. B. „Stream-Dauer aktuell").

Variablen lesen und schreiben

Variablen-Operationen im Action-Block:

• Setzen: set var X = value.
• Inkrementieren (für Counter): counter X += N.
• In Texten lesen: {X} (Variable) oder {counter:X} (Counter, explizit).

Variablen sind per Channel und überleben Streams (außer ein Counter ist auf pro Stream resetten gesetzt).

Debugging

Wenn eine Automation nicht das tut, was du erwartest:

1. /dashboard/automations/runs → letzten Lauf anklicken. Du siehst Step-by-Step, welche Condition true/false war und welche Actions geskippt wurden.
2. Bei tieferen Problemen /dashboard/automations/debug → Live-Trace mit allen Variable-Werten.
3. Wenn eine Action fehlschlägt (z. B. Discord-Webhook 500), steht das im Run-Log mit Response-Body. Externe Fehler erscheinen als action_failed mit Details — die Automation läuft danach mit den nächsten Actions weiter (kein Komplett-Abbruch, außer du setzt stop_on_failure).

Was nicht reingehört

• Sehr kurze, einfache „Sound + Overlay"-Kombis bleiben besser in einer Event Reaction — schlanker und schneller zu warten.
• Automations sind das richtige Werkzeug ab dem Moment, wo du Bedingungen, Counter oder externe Calls brauchst.

Nächste Seiten

• Cooldowns — Anti-Spam-Schutz pro Automation.
• Automation-Templates — fertige Vorlagen, die du als Startpunkt nehmen kannst.