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¶
- Reward in Twitch unter Creator Dashboard anlegen (z.B. "Cat Bild zeigen", 500 Channel Points)
- In Streamer.bot Action
[Reward] Show Cat - Triggers-Tab →
+ Add Trigger→Twitch → Channel Reward → Reward Redemption - 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¶
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¶
- Set Source Visibility State: https://docs.streamer.bot/api/sub-actions/obs-studio/sources/set-source-visibility-state
- Reward Redemption Trigger: https://docs.streamer.bot/api/triggers/twitch/channel-reward/reward-redemption