Zum Inhalt

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 simulate testen. Es spielt NGF-Aufzeichnungen als simulierte Stationen ab, so lässt sich ohne Konsolen proben.