Was ist eine Cinematic?
Eine Cinematic ist ein einziger Klick (oder Event), der mehrere bestehende Chatlix-Subsysteme gleichzeitig feuert: Licht-Puls, Overlay-Effekt und einen Eintrag im Reaction-Feed. Technisch heißt das Backend-Modul CinematicDispatch und beschreibt sich selbst als „Chain Reaction" — kein Sound, kein Video, kein echter Chat-Post. Wer sich eine Cinematic als kurzen Video-Clip vorstellt, der über OBS eingeblendet wird, liegt daneben: Es ist eine Kombi aus CSS/JS-Overlay-Flash + Lampen-Puls.
Aktuell gibt es genau fünf Cinematics, fest im Code verdrahtet (CinematicDispatch::CINEMATICS). Es gibt keinen Editor, keine Bibliothek zum Durchstöbern und keinen Upload eigener Clips — das ist bewusstes V1-YAGNI im Code kommentiert: „Wenn Adoption ergibt, dass mehr Cinematics gebraucht werden, kommt eine Tabelle. Vorher YAGNI."
Die fünf Cinematics
| Slug | Titel | Licht-Preset | Overlay-Effekt | Chat-Text (Vorschau) |
|---|---|---|---|---|
raid_explosion |
💥 Raid Explosion | raid_explosion, 8s, Pink |
flash, 1200ms |
„🚨 RAID INCOMING — der ganze Raum brennt jetzt! 🚨" |
final_boss |
⚔️ Final Boss Down | boss_kill, 4s, Gelb |
flash, 900ms |
„👑 BOSS DOWN — gz!" |
hype_peak |
🌈 Hype Peak | concert, 10s, Lila |
shockwave, 1500ms |
„🚂 HYPE TRAIN — chooo chooo!" |
horror_jumpscare |
🩸 Horror Jumpscare | horror, 5s, Blutrot |
darken, 1800ms |
„😱" |
epic_moment |
✨ Epic Moment | rare_drop, 5s, Gold |
flash, 1000ms |
„⭐ EPIC! Das war legendär." |
Wichtig zum Chat-Text: In V1 ist das nur eine Vorschau im Dashboard neben den anderen Actions (note: preview_only_v1 im Backend). Es wird nichts in deinen echten Twitch-Chat gepostet. Wenn du willst, dass sowas wirklich im Chat steht, baue eine eigene Chat-Automation.
Was beim Feuern technisch passiert
Ein Fire (POST /v1/cinematic/fire) löst parallel vier fehler-isolierte Teilaktionen aus — fällt eine aus, laufen die anderen trotzdem:
- Lighting — je nach Provider entweder direkter Cloud-Call (Govee, LIFX, Tapo) oder eine interne Zustellung für LAN-Provider (WLED, Hue, Nanoleaf, Yeelight). Zusätzlich ein separater Pfad für über Chatlix Connect gekoppelte Smart-Lights (
chatlix_bridge_smart_lights), gefiltert über Rollen wiecinematic_raid,cinematic_horror,cinematic_celebrationodercinematic_all. - Reaction-Feed — eine interne Zustellung, das Dashboard (Live-Event-Feed) zeigt sofort einen Eintrag.
- Overlay — eine interne Zustellung für jedes Overlay des Accounts (nicht nur eins).
overlay-view.jsim Browser-Source-Overlay hört auftype: 'cinematic'und spielt den Effekt. - Chat — nur die oben erwähnte Text-Vorschau, kein echter Post.
Hat ein Streamer keine Lampe verbunden, läuft die Cinematic trotzdem — Overlay und Feed feuern unabhängig davon. Das Backend markiert die Lighting-Teilaktion dann ehrlich als „kein Gerät" statt einen Fehler zu werfen.
Wie eine Cinematic ausgelöst wird
Es gibt zwei echte Auslöse-Wege — Details und Schritt-für-Schritt auf der Seite Cinematics auslösen:
- Manuell im Dashboard unter Reaction Lab (
/dashboard/reaction-lab) — ein Klick auf eine der fünf Kacheln. - Automatisch über den Game-Watcher: bestimmte Spiel-Events (z.B. Boss-Kill in Minecraft) lösen automatisch die passende Cinematic aus, fest verdrahtet im Service
GameEventCinematicMapper.
Zusätzlich gibt es Atmosphere Cinema (/dashboard/atmosphere-cinema) — das ist eine geführte Demo-Tour durch mehrere Stream-Stimmungen inklusive ein paar Cinematic-Fires, gedacht zum Vorführen/Testen, nicht als tägliches Steuer-Panel.
Es gibt keine Automation-Builder-Action „Cinematic feuern" — du kannst eine Cinematic aktuell nicht über eine eigene Automation-Regel (z.B. bei einem bestimmten Channel-Point-Redeem) triggern lassen. Das Mapping für automatische Fires ist ausschließlich das feste Game-Watcher-Mapping.
Wo das protokolliert wird
Jeder Fire landet in der Tabelle chain_reaction_events — mit Slug, Quelle (demo_fire / automation_trigger / game_event / test_fire) und dem Ergebnis jeder Teilaktion. Mehr dazu auf Cinematics Troubleshooting.