Direkt zum Hauptinhalt

Automation-Templates

Templates sind vorgefertigte Automations, die du als Startpunkt nehmen kannst, statt jede Regel von null zu bauen. Wichtig zu wissen: Chatlix hat aktuell zwei getrennte Template-Systeme an zwei verschiedenen Stellen im Dashboard — das ist keine Redundanz, sondern historisch gewachsen (älteres System vs. neueres, textbasiertes System), und beide leben parallel weiter.

System 1 — Logic-Packs (auf der Automations-Hauptseite)

Direkt auf /dashboard/automations, oben auf der Seite, siehst du eine Karte mit den aktuell verfügbaren Logic-Packs. Das ist das neuere System (Sprint 4F): bewusst schlank, rein textbasiert — keine Grafik-Assets, keine Sound-Dateien, nur Trigger + Conditions + Chat-/Zähler-Actions. Dadurch sind sie ohne Rückfrage sofort einsatzbereit, sobald du sie anwendest.

Was es aktuell gibt

PackTriggerKurzbeschreibung
raid_chat_welcome_v1 — Raid — Chat-BegrüßungraidBegrüßt eingehende Raids im Chat und erhöht einen Raid-Zähler.
follow_chat_thanks_v1 — Follow — Chat-DankfollowBedankt sich im Chat für neue Follows, zählt sie mit.
donation_logic_thanks_v1 — Donation — Chat-Dank mit Logikdonation_receivedDankt im Chat für Spenden; ab einem Schwellenwert (Standard 10,00) gibt es eine zusätzliche, stärkere Nachricht.
stream_online_chat_v1 — Stream-Start — Chat-Hinweisstream_onlinePostet eine Begrüßung im Chat, sobald der Stream live geht.
ad_break_bot_message_v1 — Twitch Werbung — Chat-Hinweisad_break_beginPostet automatisch eine Chat-Nachricht bei Werbebeginn. Braucht den Twitch-Scope channel:read:ads.

Ablauf: « Vorschau » zeigt dir schreibfrei, was das Pack anlegen würde (keine DB-Schreibaktion). « Anwenden » erzeugt eine neue Automation in deiner Liste — immer hart deaktiviert, egal was das Pack als Default vorsieht. Du prüfst die Regel also erst in Ruhe und schaltest sie danach selbst ein. Das ist Absicht: kein Pack soll ungeprüft live in deinen Chat posten.

System 2 — Klassische Template-Bibliothek

Unter /dashboard/automation-templates liegt die größere, kategorisierte Bibliothek (älteres System, DB-gestützt statt hart-codiert). Hier findest du mehr Umfang und auch Templates mit Grafik-/Sound-Bezug.

Wo

  • /dashboard/automation-templates — Browse-Ansicht aller Templates, filterbar nach Kategorie.
  • Beim Anlegen einer neuen Automation auf /dashboard/automations: die Leerzustand-Ansicht („noch keine Automations") blendet ebenfalls kuratierte Templates zum Direktstart ein.

Was Templates enthalten

  • Trigger vorkonfiguriert (z. B. Bits-Cheer, Sub, Hype-Train, Timer …).
  • Conditions als Vorschlag (z. B. „nur Bits ≥ 100").
  • Actions als komplette Sequenz inkl. Defaults.
  • Cooldowns sinnvoll vorbelegt.
  • Ein min_plan-Flag — manche Templates sind erst ab einem bestimmten Plan nutzbar (z. B. wenn sie mehr Actions enthalten, als dein actions_per_automation-Limit erlaubt).

Beispiele aus der Bibliothek:

Cheer-Konfetti alle 100 Bits

  • Trigger: cheer. Condition: bits >= 100.
  • Actions: increment_counter cheer_bursts, trigger_overlay_alert Konfetti, send_chat „{user} hat 100+ Bits gecheert, danke!".
  • Cooldown: global 15 s.

Sub-Sound + Overlay (3 Tiers)

  • Trigger: sub. Unterscheidung nach Tier über eine Condition pro Action-Gruppe (event_field_equals field=tier value=1000|2000|3000).
  • Tier 1: kurzer Sound + Standard-Overlay. Tier 2: längerer Sound + Premium-Overlay. Tier 3: Sequenz mit TTS-Dank (speak_text).
  • Cooldown: global 5 s (gegen Mass-Gift-Sub-Burst) — noch sauberer mit dem Trigger gift_bomb kombiniert.

Raid-Welcome ≥ 5 Viewer

  • Trigger: raid. Condition: event_field_gt field=raid_size value=4.
  • Actions: Sound → stage_delay 1,5 s → Raid-Banner-Overlay → stage_delay 3 s → Chat-Begrüßung.
  • Cooldown: channel 60 s.

Stream-Start-Routine

  • Trigger: stream_online.
  • Actions: obs_switch_scene Intro → stage_delay 5 s → obs_switch_scene Hauptszene → webhook_send Discord → set_variable stream_started_at.
  • Cooldown: global 3600 s.

Hype-Train-Eskalation

  • Trigger: hype_train_progress. Mehrere Conditions nach Level (1–5), pro Level eskalierende Overlays + Sounds.

Erst-Follower-Begrüßung

  • Trigger: first_chatter oder follow mit Pro-Zuschauer-Sperre viewer_ever.
  • Action: speak_text „Willkommen {user}, schön dass du da bist!".

Discord-Live-Ankündigung

  • Trigger: stream_online. Action: discord_send_embed mit Stream-Titel, Spiel, Vorschau-Link.
  • Cooldown: global 3600 s.

Die Bibliothek verändert sich weiter — schau bei Bedarf direkt in /dashboard/automation-templates nach dem aktuellen Stand, statt dich blind auf diese Liste zu verlassen.

Template anwenden — Schritt für Schritt

  1. /dashboard/automation-templates öffnen.
  2. Template suchen (Kategorie-Filter, z. B. Engagement, Monetarisierung, Stream-Lifecycle).
  3. « Vorschau » zeigt den fertigen Aufbau ohne Anwenden.
  4. « Anwenden » öffnet einen Parameter-Dialog: dort wählst du z. B. welchen Sound, welches Overlay, welche Discord-Webhook-URL, welchen Zielkanal.
  5. « Erstellen » legt die Automation in deiner Liste an — auch hier standardmäßig deaktiviert.
  6. Prüfen, anpassen, testen (« Test »/« Test-Fire » im Editor), dann aktivieren.

Das Template-System ist Read-Only — du modifizierst nicht das Template selbst, sondern erzeugst eine eigene Kopie. Updates an einem Template ändern bestehende Kopien nicht rückwirkend.

Eigene Automations als Vorlage wiederverwenden

Willst du eine fertige, selbstgebaute Automation auf einen zweiten Kanal oder Account übertragen, ist der richtige Weg aktuell Export/Import (GET /v1/automations/export → POST /v1/automations/import), nicht ein „Als Template speichern"-Knopf im klassischen Sinn. Export ist strikt auf deine eigenen Regeln beschränkt, entfernt alle Laufzeitdaten (IDs, Zähler, Zeitstempel) und redigiert Geheimnisse (Webhook-Secrets, Discord-Token) automatisch zu einem Platzhalter. Details dazu auf der Seite Automations Grundlagen. Ein Teilen von Templates zwischen fremden Accounts über die Bibliothek selbst ist nicht vorgesehen — die kuratierten Templates/Logic-Packs kommen von Chatlix, nicht von anderen Nutzern.

Wann Templates/Packs eher nicht

  • Wenn deine Automation sehr spezifisch ist (krumme Zähler-Bedingungen, ungewöhnliche externe Webhooks, mehrstufige script_block-Logik) — dann bist du schneller, wenn du from scratch baust.
  • Wenn du ein Template nur zur Hälfte nutzen würdest — manchmal ist Abschneiden mehr Arbeit als Neu-Anlegen.
  • Logic-Packs sind bewusst textbasiert ohne Grafik/Sound — für aufwendigere Overlay-Sequenzen brauchst du die klassische Bibliothek oder einen eigenen Aufbau.

Für alles, was sich als „Standard-Streamer-Setup" beschreiben lässt (Raid-Welcome, Follow-Dank, Stream-Start-Routine, Ad-Break-Hinweis), sparen Templates und Logic-Packs ehrlich die meiste Zeit. Schau ruhig durch beide Bibliotheken, bevor du eine neue Automation komplett neu baust.

Siehe auch

  • Automations Grundlagen — vollständiger Trigger-/Action-Katalog, Plan-Limits, Export/Import.
  • Erste Automation bauen — Grundlagen, falls du dann doch from scratch willst, inkl. dem Ad-Break-Beispiel.
  • Cooldowns — verstehen, was die Templates da im Hintergrund konfigurieren.