Cooldowns

Cooldowns 
 Cooldowns verhindern, dass eine Automation zu oft hintereinander feuert. Praxisbeispiel: Du hast eine Sub-Sound-Automation, jemand verschenkt 50 Subs auf einmal — ohne Cooldown krachen 50 Sounds übereinander und drücken den Stream-Ton runter. 
 In Chatlix gibt es drei Cooldown-Ebenen , die du pro Automation einzeln einstellst. 
 Die drei Ebenen 
 
 
 
 Ebene 
 Wirkung 
 
 
 
 
 Pro Automation (global) 
 Die Automation kann insgesamt nur alle X Sekunden feuern, egal wer triggert. 
 
 
 Pro User 
 Pro Zuschauer kann sie alle X Sekunden feuern. Andere User triggern normal weiter. 
 
 
 Pro Channel 
 Bei Multi-Channel-Setups: pro Twitch-Channel. Für Single-Streamer ohnehin gleich wie global . 
 
 
 
 Du kannst alle drei gleichzeitig setzen. Sie werden geprüft und der strengste gewinnt. 
 Wo du das einstellst 
 Im Automation-Editor unter dem Abschnitt Cooldowns . Drei Felder, jeweils in Sekunden, leer = kein Cooldown: 
 
 global_cooldown_seconds 
 per_user_cooldown_seconds 
 per_channel_cooldown_seconds 
 
 Typische Werte 
 
 Sub-Sound : global = 5 s . Damit klingen Mass-Gift-Subs wie ein angenehmer Schauer, nicht wie ein Wasserfall. 
 Chat-Befehl !song : per_user = 60 s . Stamm-Zuschauer können trotzdem alle paar Minuten neu anfragen, aber niemand spammt. 
 Cheer-Konfetti : global = 30 s . Sieht auch bei vielen kleinen Cheers entspannt aus. 
 Discord-Webhook „Live-Ankündigung" : global = 3600 s (1 h). Verhindert doppel-Pings, falls Stream-Online zweimal hintereinander getriggert wird. 
 
 Was passiert, wenn ein Cooldown greift 
 Im Run-Log ( /dashboard/automations/runs ) taucht ein Eintrag mit Status skipped_cooldown auf. Trigger ist aufgezeichnet, aber keine Action wurde ausgeführt. So siehst du auch im Nachhinein, wann der Cooldown gegriffen hat — wichtig für Tuning. 
 Der Trigger wird nicht in eine Warteschlange gepackt . Wenn der Cooldown abläuft, läuft die Automation nicht „nachträglich" für den verpassten Trigger an. Das ist Absicht (sonst hättest du nach einem 50-Gift-Sub-Burst eine Sound-Lawine, die 5 Minuten nachläuft). 
 Globaler vs. Action-Cooldown 
 Der Cooldown wirkt auf die ganze Automation , nicht auf einzelne Actions in ihr. Wenn du innerhalb einer Automation mehrere Sounds hast und nur einen davon cooldownen willst — geht nicht direkt. Workaround: die kritische Action in eine eigene Sub-Automation auslagern und per Webhook von der Haupt-Automation aufrufen. Selten nötig. 
 Cooldown + Burst-Schutz 
 Für Bit-Bursts (jemand cheered 5× hintereinander in 10 Sekunden) gibt es zusätzlich einen internen Anti-Burst-Schutz in den Action-Queues: gleiche Action wird nicht öfter als ~1×/Sekunde an OBS/Browser geschickt, selbst wenn die Automation rein logisch öfter feuern dürfte. Das siehst du nicht im Editor, läuft automatisch und schützt die Render-Engine. 
 Cooldown-Reset 
 Im Editor gibt es einen « Cooldown-Reset » -Button. Praktisch beim Testen: setzt alle laufenden Cooldown-Zeiten für diese Automation auf 0, sodass der nächste Trigger sofort durchgeht. 
 Laufende Cooldowns überleben übrigens nicht einen Stream-Restart wenn du per_user_cooldown mit „pro Stream" markierst (Toggle daneben). Standard ist persistent . 
 Beispiel-Setup: Mass-Gift-Sub-Welcome 
 Szenario: Jemand verschenkt 25 Subs auf einmal. Twitch feuert 25 Sub-Events (plus 1 Gift-Sub-Sammel-Event). Du willst: 
 
 Nicht 25× den Sub-Sound spielen. 
 Aber jedem geschenkten User eine Loyalty-Punkte-Belohnung geben. 
 
 Lösung: zwei Automations . 
 
 Sub-Sound → Trigger Sub → global_cooldown = 5 s . Spielt also max alle 5 s einen Sound. Bei 25 Mass-Gift-Subs: 1 Sound, der Rest wird skipped_cooldown . 
 Loyalty-Bonus → Trigger Sub → kein Cooldown. Action: Loyalty +10 für {user} . Läuft 25×, jeder Gift-Empfänger kriegt seinen Bonus. 
 
 Getrennte Cooldowns für unterschiedliche Ziele — das ist der Hebel. 
 Was Cooldowns nicht ersetzen 
 
 Twitch-Reward-Limits : die laufen in Twitch und sind separat. Wenn du Channel-Points-Rewards limitieren willst, mach das in Twitch (siehe Buch Rewards , Seite Reward-Limits ). 
 OBS-Drosselung : hat ihre eigene 1/s-Bremse für Szenenwechsel. 
 Externe API-Rate-Limits : dein Discord-Webhook hat eigene Limits — die Automation umgeht die nicht. 
 
 Diagnose 
 Wenn eine Automation seltener läuft als erwartet: 
 
 In /dashboard/automations/runs filtern auf status = skipped_cooldown . Wenn da viele Einträge sind, ist der Cooldown zu streng eingestellt. 
 Bei per_user_cooldown : prüfen, dass der User-Bezug korrekt erkannt wird. Trigger ohne User-Bezug (z. B. Stream-Online) sollten keine per_user_cooldown -Logik haben — leer lassen. 
 
 Siehe auch 
 
 Automations Grundlagen — Übersicht. 
 Automation-Templates — viele Templates haben sinnvolle Default-Cooldowns vorkonfiguriert.