Systemüberblick¶
Die Retroverse-NestrisLTM-Suite besteht aus vier Projekten, die ein Classic-NES-Tetris-Turnier von der Erfassung bis zur Übertragung abwickeln. Statt Klemmbrett, Tabellen und abgetippter Scores gibt es automatische, überprüfbare Ergebnisse.
In einem Satz
Ein kleiner PC neben jedem NES liest das Spiel aus dem Videosignal. Eine RFID-Karte sagt ihm, wer spielt. Ein zentraler Host-PC sammelt jedes Spiel, erstellt die Rangliste und versorgt Stream und Bildschirme in der Halle.
Wer nutzt das System?¶
| Rolle | Was sie davon haben |
|---|---|
| Veranstalter | Eine Admin-Oberfläche für Spieler, Spiele, Events, Stationen und den Turnierbaum. Cheats und verdächtige Spiele werden markiert, und jede Änderung steht im Audit-Log. |
| Spieler | Einmal am Touch-Terminal anmelden und eine persönliche Karte bekommen. Karte an einer Station auflegen: Platzierung und Bestwert erscheinen am Display des Lesers, und jedes Spiel lässt sich später als Replay ansehen. |
| Streamer / Kommentatoren | Transparente 1080p-Browserquellen für OBS mit Single-, 1v1- und 4-Spieler-Layouts. Sie zeigen Live-Spielfelder, die Score-Differenz und „braucht N Tetrisse“. |
| Publikum | Eine Vollbild-Highscore-Anzeige mit Live-Updates, Rekord-Bannern, animiertem Turnierbaum und Siegerfeier. |
Die Komponenten¶
| Komponente | Was sie ist | Läuft auf | Status | Links |
|---|---|---|---|---|
| NestrisLTM | Host-App: Ingest, Datenbank, Admin, Overlays, Anzeigen, Updates | Windows-10/11-Host-PC (headless auch unter Linux) | Beta | Repo · Releases |
| nestris-core | Erkennungs-Engine (Rust), Dienst nestris-station, CLI, Desktop- und Web-GUIs | Debian-12/13-Stationen, Windows, Linux, macOS, Browser | Beta | Repo · Releases |
| nestris-terminal | Touch-Kiosk für Anmeldung, Spielerprofile und Replays | Windows-10/11-Touch-PC | Beta | Repo · Releases |
| nestris-rfid-reader | ESP32-Firmware für den Kartenleser mit OLED, Protokoll v2 | ESP32 DevKit + RC522 + SSD1306 | Preview | Repo · Releases |
Das Gesamtbild¶
flowchart LR
subgraph STATIONS["Capture-Stationen · eine pro Konsole"]
direction TB
subgraph S1["Station 1"]
direction LR
N1["<span style='color:#f8fafc'>🎮 NES</span>"]:::hw --> C1["<span style='color:#f8fafc'>USB-Capture</span>"]:::hw --> ST1["<span style='color:#111111'>nestris-station</span>"]:::core
R1["<span style='color:#111111'>RFID-Leser</span>"]:::rfid -- USB-Seriell --> ST1
end
subgraph S2["Station n"]
direction LR
N2["<span style='color:#f8fafc'>🎮 NES</span>"]:::hw --> C2["<span style='color:#f8fafc'>USB-Capture</span>"]:::hw --> ST2["<span style='color:#111111'>nestris-station</span>"]:::core
R2["<span style='color:#111111'>RFID-Leser</span>"]:::rfid -- USB-Seriell --> ST2
end
end
subgraph HOST["Host-PC"]
direction TB
MQ["<span style='color:#ffffff'>Mosquitto<br/>MQTT-Broker</span>"]:::ext --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
LTM <--> DB[("<span style='color:#ffffff'>PostgreSQL</span>")]:::ext
end
subgraph KIOSK["Anmeldung"]
direction LR
R3["<span style='color:#111111'>RFID-Leser</span>"]:::rfid -- USB-Seriell --> TERM["<span style='color:#111111'>nestris-terminal</span>"]:::term
end
subgraph SCREENS["Ausgaben"]
direction TB
OBS["<span style='color:#ffffff'>OBS / Stream-PC</span>"]:::ext
HS["<span style='color:#ffffff'>Highscore- &<br/>Turnierbaum-Anzeige</span>"]:::ext
ADM["<span style='color:#ffffff'>Admin-Browser</span>"]:::ext
end
ST1 & ST2 -- "MQTT 1883" --> MQ
ST1 & ST2 -- "HTTP 7990 · .ngf.gz-Upload" --> LTM
TERM -- "HTTP 7990 · REST" --> LTM
LTM -- "HTTP / WebSocket 7990" --> OBS & HS & ADM
LTM -. "cmd: Platz am Leser" .-> MQ
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef rfid fill:#f472b6,stroke:#be185d,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
Designprinzipien¶
-
Lokal zuerst
Alles läuft im Event-LAN. Während des Turniers wird kein Internet gebraucht. Updates werden nur geladen, wenn eines verfügbar ist.
-
Ergebnisse sind Beweise
Jedes Spiel wird framegenau aufgezeichnet (NGF), geprüft und auf Cheats untersucht. Bei Streitfällen entscheidet das Replay.
-
Selbstheilend
Stationen starten die Erfassung neu, verbinden Leser und Broker selbstständig wieder und senden zwischengespeicherte Ergebnisse nach. Die Host-App läuft im Tray mit Statusanzeige.
-
Lose gekoppelt
Die Komponenten sprechen über dokumentierte Schnittstellen: MQTT, REST, serielles JSON und NGF. Jeder Teil lässt sich einzeln testen und austauschen.
Wie geht's weiter?¶
- Systemarchitektur: das Innenleben jeder Komponente.
- Aufbau & Topologien: von der Demo mit einer Konsole bis zur vollen Turnierhalle.
- Ablauf eines Spiels: was zwischen „Karte am Leser“ und „Score im Stream“ passiert.
- Event aufbauen: Schritt-für-Schritt-Checkliste für Veranstalter.