Zum Inhalt

Source Toggle via Channel-Point-Reward

Viewer löst einen Channel-Point-Reward ein → OBS-Source wird für X Sekunden eingeblendet (z.B. Spinning Logo, GIF, Soundbite). Klassisches "Hydrate Reminder" oder "Show Cat" Pattern.

Voraussetzung: OBS-Verbindung (siehe setup.md) Patterns: Set Source Visibility State + Delay Trigger: Twitch → Channel Reward → Reward Redemption Sub-Actions: 3-5

Action: [Reward] Show Cat

Trigger anlegen

  1. Reward in Twitch unter Creator Dashboard anlegen (z.B. "Cat Bild zeigen", 500 Channel Points)
  2. In Streamer.bot Action [Reward] Show Cat
  3. Triggers-Tab → + Add TriggerTwitch → Channel Reward → Reward Redemption
  4. Im Trigger-Dialog: Reward Filter → das angelegte Reward auswählen (per Name oder ID)

Variablen vom Reward Trigger:

Variable Inhalt
%user% Display Name des Redeemers
%userName% Login
%input% Falls Reward Text-Input verlangt: das was User getippt hat
%rewardId% Reward GUID
%rewardName% Reward Titel
%rewardCost% Anzahl Channel-Points

Sub-Action 1: Set Source Visibility State — Zeigen

Pfad: OBS Studio → Sources → Set Source Visibility State

Feld Wert
Connection Default
Scene Main (deine aktive Scene wo Cat-Source liegt)
Source Cat-Image (Source-Name aus OBS)
State Visible

Sub-Action 2: Send Message

Feld Wert
Message 🐱 @%user% hat das Cat-Bild eingelöst!

Sub-Action 3: Delay

Pfad: Core → Uncategorized → Delay

Feld Wert
Duration 8000 ms (8 Sekunden Anzeige)

Sub-Action 4: Set Source Visibility State — Verstecken

Feld Wert
Scene Main
Source Cat-Image
State Hidden

Action-Tree

[Reward] Show Cat  (Trigger: Reward Redemption "Show Cat")
├── 1. Set Source Visibility: Main → Cat-Image = Visible
├── 2. Send Message: "🐱 @%user% hat das Cat-Bild eingelöst!"
├── 3. Delay 8000 ms
└── 4. Set Source Visibility: Main → Cat-Image = Hidden

Variante: Toggle (an/aus) statt Auto-Hide

Set Source Visibility:
  State = Toggle

Jedes Reward-Einlösen schaltet die Source ein oder aus. Vorsicht: wenn Source nicht zurückgeht (z.B. Stream-Lag), bleibt sie an.

Variante: Random-Image aus mehreren

Pfad: OBS Studio → Groups → Set Random Group Source Visible

Feld Wert
Scene Main
Group Cat-Images (OBS-Group mit mehreren Cat-Sources drin)

OBS wählt zufällig EINE Source aus der Group sichtbar. Nice für Variety bei Rewards die "Bild aus Pool zeigen" sollen.

Variante: Source + Sound parallel

[Reward] Show Cat
├── 1. Play Sound (cat-meow.mp3)        Core → Sounds → Play Sound
├── 2. Set Source Visibility: Visible
├── 3. Delay 8000 ms
└── 4. Set Source Visibility: Hidden

Variante: GIF (Media Source) statt Bild

Wenn die Source eine Media Source ist (GIF, MP4):

1. Set Media Source File         (Pfad zur Datei, falls dynamisch)
2. Set Media State: Restart       (von vorne abspielen)
3. Set Source Visibility: Visible
4. Delay (Dauer des GIFs in ms)
5. Set Source Visibility: Hidden

Pfad: OBS Studio → Sources → Set Media State mit State Restart.

Reward via API verwalten

Statt im Twitch-Dashboard kannst du Rewards auch komplett aus Streamer.bot heraus anlegen/ändern. Siehe Welle 1D (Channel-Point-Rewards) für volle Reward-Verwaltung.

Häufige Fallen

  • Source bleibt sichtbar nach Stream-Crash — wenn SB oder OBS crasht zwischen "Visible" und "Hidden". Lösung: separater [Stream Online] Trigger der alle Reward-Sources auf Hidden setzt
  • Reward Cooldown vergessen — bei populären Rewards Spam-Schutz im Twitch-Reward selbst aktivieren (Per-User Cooldown, Max Per Stream)
  • Reward nicht zurückerstattet bei Fehler — siehe Update Redemption Status Welle 1D — kommt da

Quellen