Streaming & OBS¶
NestrisLTM zeichnet jedes Overlay im Browser. In OBS wird es als Browserquelle mit 1920×1080 eingebunden. Der Hintergrund ist transparent, das Overlay lässt sich also über eigene Kamerabilder, Grafiken oder das rohe Konsolenbild legen.
flowchart LR
ST1["<span style='color:#111111'>Station 1</span>"]:::core & ST2["<span style='color:#111111'>Station 2</span>"]:::core -- "live 60 Hz" --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
LTM -- "WebSocket /ws/scene/{slug}" --> BS["<span style='color:#ffffff'>OBS-Browserquelle<br/>/o/{slug}</span>"]:::ext
CAM["<span style='color:#f8fafc'>Kameras · Konsolenbild</span>"]:::hw --> OBS["<span style='color:#ffffff'>OBS-Szene</span>"]:::ext
BS --> OBS --> OUT["<span style='color:#ffffff'>📡 Stream / Beamer</span>"]:::ext
DECK["<span style='color:#ffffff'>Stream Deck</span>"]:::ext -- "POST /api/scenes/{slug}/rounds" --> LTM
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3
Szenen¶
Eine Szene hat eine feste URL /o/<slug>, ein Layout und eine Station pro Slot. Welche Stationen eine Szene speisen, wird in der Admin-Oberfläche (Szenen) eingestellt, OBS muss während des Events nie angefasst werden.
| Layout | Slots | Typischer Einsatz |
|---|---|---|
single |
1 | Einen Spieler mit vollem Spielfeld und Statistik zeigen |
single_compact |
1 | Kleinere Einzelbox für eine Bildschirmecke |
1v1 |
2 | Turnierbaum-Match: zwei Spieler direkt gegeneinander |
2x1v1 |
4 | Zwei Matches nebeneinander |
4p |
4 | Vierer-Lauf (Modi siehe unten) |
replay |
1 | Aufgezeichnetes Spiel im Stream abspielen |
4-Spieler-Modi¶
| Modus | Wer kommt weiter |
|---|---|
none |
Niemand: Showmatch ohne Ergebnisstempel |
top2_advance |
Die besten zwei kommen weiter (WEITER), die anderen sind draußen (RAUS) |
worst_out |
Alle außer dem niedrigsten Score kommen weiter |
winner_only |
Nur der Beste gewinnt (SIEGER) |
Ein Ergebnis wird gestempelt, sobald es feststeht, nicht erst, wenn alle Spiele vorbei sind. Ein fertiger Spieler gilt zum Beispiel als weiter, sobald ihn nicht mehr genug Spieler überholen können.
Was das Overlay zeigt¶
- NES-getreue Spielfelder mit 60 Hz in den originalen Level-Farben, inklusive fallendem Teil.
- Score, Lines, Level, nächstes Teil, Tetris-Rate, Burn und Drought. Eine Drought ab 13 Teilen blinkt.
- Ein Tetris lässt das Spielfeld aufblitzen, wie an der Konsole.
- Versus-Werte, am Server berechnet:
- Score-Differenz und Live-Differenzgraph
- Vorsprung in Tetrissen: Vorsprung ÷ (1200 × (Level + 1)) des zurückliegenden Spielers
- Pace hochgerechnet auf Level 29
- „braucht N Tetrisse“ für den zurückliegenden Spieler
- Ergebnisstempel (WEITER / RAUS / SIEGER), sobald eine Runde entschieden ist.
Runden¶
stateDiagram-v2
direction LR
state "Wartet" as Waiting
state "Spielt" as Playing
state "Eingefroren" as Frozen
[*] --> Waiting
Waiting --> Playing: Spiel startet auf dem Slot
Playing --> Frozen: Spiel endet, Ergebnis eingefroren
Frozen --> Frozen: weitere Spiele auf dem Slot ignoriert
Frozen --> Waiting: Neue Runde / Auto-Runde / Stream Deck
Frozen --> Waiting: Slot zurücksetzen (einzelner Slot)
Das Ergebnis eines Slots friert ein, sobald sein Spiel endet. Startet ein Spieler versehentlich ein neues Spiel, überschreibt das sein Ergebnis also nicht. Die Crew startet die nächste Runde per Klick, automatisch oder mit einer Stream-Deck-Taste. Die Taste ruft POST /api/scenes/{slug}/rounds mit einem Token mit Scope scenes auf.
Highscore-Anzeige im Stream¶
Die Vollbild-Anzeige für Highscore und Turnierbaum lässt sich ebenfalls in OBS nutzen:
http://<host>:7990/view/highscore?transparent=1
http://<host>:7990/view/highscore?only=bracket&transparent=1
Die Turnierkonsole steuert sie fern: Schriftgröße, Autoscroll, Effekte, Banner, Transparenz und Siegerfeier.
Tipps für OBS¶
- Die Browserquelle auf 1920×1080 stellen. Quelle herunterfahren, wenn nicht sichtbar nur aktivieren, wenn ein kurzes Neuverbinden beim Szenenwechsel nicht stört.
- Den Stream-PC per Kabel anschließen. Jedes Overlay hält eine WebSocket-Verbindung zum Host offen.
- Jede Szene mit
nestris-ltm simulatetesten. Es spielt NGF-Aufzeichnungen als simulierte Stationen ab, so lässt sich ohne Konsolen proben.