Reward-Limits

Reward-Limits verhindern, dass ein einzelner Zuschauer einen Reward spammt oder dass ein Reward den Stream übernimmt. Wichtig zum Verständnis: Es gibt zwei komplett getrennte Limit-Ebenen — Twitch-seitige Limits am Reward selbst, und Chatlix-eigene Cooldown-/Duplikat-Einstellungen am Binding. Beide wirken unterschiedlich und an unterschiedlichen Stellen der Kette. Wer das verwechselt, wundert sich, warum Kanalpunkte abgebucht wurden, obwohl „doch ein Cooldown lief".

Ebene 1: Twitch-seitige Limits (am Reward selbst)

Twitch-Creator-Dashboard → Channel Points → Manage Rewards → den Reward bearbeiten → Abschnitt Advanced Settings. Wenn du den Reward direkt aus Chatlix erstellst, setzt du dieselben Werte schon im Anlage-Formular (siehe Reward erstellen).

Global Cooldown

• Nach einer Einlösung ist der Reward für alle Zuschauer für X Sekunden/Minuten gesperrt.
• Sinnvoll für laute oder szenenwechselnde Rewards (Sirene, Disco-Modus, Pyro).
• Faustregel: 30–120 Sekunden für Audio/Szenenwechsel, 10–30 Sekunden für reine Overlay-Pop-ups.

Max per Stream / Max per User per Stream

• Wie oft der Reward während einer Stream-Session insgesamt bzw. pro einzelnem Zuschauer eingelöst werden darf.
• Praktisch für seltene Rewards (Wunschsong: 3× pro Stream, 1× pro Nutzer).
• Twitch resettet das automatisch bei Stream-Start.

Entscheidend: Wenn ein Twitch-seitiges Limit greift, lehnt Twitch selbst die Einlösung ab, bevor Chatlix überhaupt etwas davon mitbekommt. Der Zuschauer sieht eine Meldung wie „Auf Cooldown" oder „Maximum erreicht", die Kanalpunkte werden nicht abgebucht, und in Chatlix erscheint dazu gar kein Event.

Ebene 2: Chatlix-eigene Limits (am Binding)

Das ist der Teil, der in der Praxis öfter für Verwirrung sorgt: Zusätzlich zu allem, was du in Twitch einstellst, hat jedes Reward-Binding in Chatlix selbst zwei eigene Felder, direkt in der Bearbeitungsansicht unter /dashboard/reward-bindings:

• Cooldown (Sekunden, global): 0–3600 Sekunden. Blockiert die Aktion für alle Zuschauer, unabhängig davon, was Twitch am Reward selbst konfiguriert hat.
• Duplikat-Schutz (Sekunden, pro Nutzer): 0–300 Sekunden. Verhindert, dass derselbe Zuschauer die Aktion innerhalb des Zeitfensters mehrfach auslöst (nützlich gegen Twitch-seitige doppelte Zustellung oder Doppelklicks).

Der wichtige Unterschied zu Ebene 1: Diese Chatlix-Limits greifen nachdem Twitch die Einlösung bereits akzeptiert und die Kanalpunkte bereits abgebucht hat. Blockiert der Chatlix-Cooldown, wird die Aktion nicht ausgeführt (Log-Eintrag reward_blocked_cooldown bzw. reward_blocked_dup), aber der Zuschauer hat trotzdem bezahlt. Das ist bewusst so gebaut (Twitch selbst kennt keinen zweiten, Chatlix-spezifischen Cooldown-Mechanismus), aber ein Fallstrick, wenn du dir nicht bewusst bist, dass beide Ebenen existieren.

Praxis-Empfehlung: Setz identische oder etwas großzügigere Cooldown-Werte auf beiden Ebenen. Twitch-Cooldown verhindert unnötige Abbuchungen (fair für den Zuschauer), Chatlix-Cooldown ist deine Rückfallebene, falls du den Twitch-Cooldown mal vergisst oder ein Zuschauer über zwei verschiedene, aber gleich gebundene Wege einlöst.

Reset-Verhalten unterscheidet sich ebenfalls

Twitchs Max-per-Stream-Zähler resetten beim Stream-Start. Chatlix' Cooldown/Duplikat-Schutz laufen dagegen über Redis mit fester TTL (Time-to-Live) ab dem Zeitpunkt der letzten Einlösung — die haben nichts mit deinem Stream-Start/-Ende zu tun. Ein 300-Sekunden-Chatlix-Cooldown ist 300 Sekunden nach der letzten Einlösung vorbei, egal ob der Stream dazwischen endet oder nicht.

Pro Binding, nicht pro Aktions-Typ

Cooldown und Duplikat-Schutz gelten pro Binding (also pro Twitch-Reward), nicht pro Aktions-Typ. Bindest du z. B. zwei verschiedene Twitch-Rewards an je einen Overlay-Alert mit demselben Overlay, haben beide ihren eigenen, unabhängigen Cooldown — es gibt kein automatisches „dieses Overlay hat insgesamt maximal alle 60s einen Alert" über Bindings hinweg. Innerhalb eines Bindings gilt der Cooldown dafür für alle daran hängenden Aktionen gemeinsam (ein Binding kann ja mehrere Aktionen haben, siehe Reward erstellen) — du brauchst also keine zusätzliche Automation-Ebene mehr, nur um mehrere Aktionen eines Rewards gemeinsam zu drosseln.

Willst du wirklich einen Cooldown, der über mehrere verschiedene Twitch-Rewards hinweg gilt (z. B. „Konfetti-Overlay, egal über welchen der drei Rewards ausgelöst"), gibt es dafür aktuell keinen eingebauten Mechanismus in den Reward-Bindings — das müsstest du derzeit über die Twitch-seitigen Limits der einzelnen Rewards approximieren.

Chatlix-seitige Schutzmaßnahmen, die du nicht einstellst

Unabhängig von den beiden konfigurierbaren Limit-Ebenen hat Chatlix zusätzlich eine harte technische Drosselung für OBS-Aufrufe: Der interne RPC-Call zu Chatlix Connect für OBS-Aktionen hat ein Timeout von 1,5 Sekunden, damit ein Burst von Einlösungen (z. B. während eines Hype-Trains) nicht sämtliche PHP-FPM-Worker blockiert, falls Connect gerade lahmt. Das läuft automatisch im Hintergrund, ist nicht einstellbar und hat mit den Cooldown-Feldern oben nichts zu tun.

Limits taktisch nutzen

Ein paar Muster aus der Praxis (Twitch-Werte in Klammern, Chatlix-Binding-Werte als Ergänzung):

• „Big Spender"-Reward: hohe Kosten (10 000+ Punkte), keine Twitch-Limits, Chatlix-Cooldown 0 — Zuschauer, die viel zuschauen, dürfen sich auch viel leisten.
• „Soundboard/Overlay"-Rewards: niedrige Kosten (50–200 Punkte), Twitch Global Cooldown 60 s, Twitch Max per User per Stream 2, Chatlix-Cooldown zusätzlich 30–60 s als Fallback. Damit kann jeder mal, aber niemand spammt — und falls der Twitch-Cooldown mal nicht greift, bremst Chatlix trotzdem.
• „Wunschsong/Wunsch-Szene"-Reward: hohe Kosten, Twitch Max per Stream 3, Max per User per Stream 1. Fair und kontrolliert, Chatlix-Cooldown eher niedrig (0–10 s), weil das Twitch-Limit hier die eigentliche Bremse ist.
• „Mod-Hilfe"-Rewards (z. B. Timeout entfernen): hohe Kosten, manuelle Queue in Twitch (Skip Request Queue auslassen), kein Chatlix-Binding nötig — bewusst eine manuelle Entscheidung pro Einlösung statt Auto-Aktion.

Was passiert, wenn ein Limit greift — Kurzreferenz

Beschweren sich Zuschauer über zu harte Twitch-Limits: in Twitch lockern, wirkt sofort. Merkst du, dass trotz gefühlt passendem Twitch-Cooldown Aktionen doppelt feuern: schau dir den Chatlix-Cooldown/Duplikat-Schutz am Binding an, der ist unabhängig davon.

Siehe auch

• Reward erstellt aber nichts passiert — wenn kein Limit der Grund ist, sondern etwas anderes klemmt, inklusive vollständiger Liste der Dispatch-Response-Codes.
• Reward erstellen — wo genau du Cooldown/Duplikat-Schutz am Binding einstellst und wie du mehrere Aktionen an ein Binding hängst.
• /dashboard/channel-point-sets — wenn du ganze Reward-Gruppen spielabhängig ein-/ausschalten willst, statt einzelne Cooldowns zu jonglieren.