Retroverse · Classic NES Tetris
NestrisLTM
Local Tournament Manager¶
Vom NES am Tisch bis zur Anzeigetafel an der Wand: NestrisLTM liest jedes Spiel direkt aus dem Videosignal der Konsole. Die RFID-Spielerkarte sagt, wer spielt. Live-Scores, Versus-Overlays und Turnierbäume landen automatisch auf dem Bildschirm, ohne Abtippen und ohne Cloud.
Beta · Work in Progress
Die NestrisLTM-Suite ist in der Beta-Phase und wird laufend weiterentwickelt. Sie ist bei Retroverse bereits im Einsatz, aber Funktionen, Schnittstellen und diese Dokumentation können sich zwischen Releases noch ändern. Einzelne Teile sind als Preview oder Geplant markiert. Rückmeldungen und Fehlerberichte sind auf GitHub willkommen.
Was ist das?¶
NestrisLTM ist die Software hinter dem Classic-NES-Tetris-Turnier bei Retroverse, einem Retro-Gaming-Event in Wattens, Tirol. Sie macht aus einem Raum voller NES-Konsolen ein vollständig erfasstes Turnier:
- Capture-Stationen beobachten jede Konsole über einen USB-Capture-Stick und erkennen in Echtzeit Score, Lines, Level, das nächste Teil und das ganze Spielfeld.
- RFID-Spielerkarten zeigen, wer spielt. Karte auflegen, und die Station ordnet das Spiel dem Spieler zu.
- Die Host-App sammelt alle Spiele in einer Datenbank. Sie führt Highscore und Turnierbaum und liefert sendefertige OBS-Overlays und Vollbild-Anzeigen.
- Ein Touch-Terminal dient zum Anmelden: Spieler bekommen dort ihre Karte, sehen ihre Statistiken und schauen Replays ihrer eigenen Spiele an.
Die vier Bausteine¶
-
NestrisLTM
Die Host-Anwendung: Datenbank, Admin-Oberfläche, Highscore, Turnierbaum, OBS-Szenen und Update-Manager. Läuft als Windows-Tray-App.
-
nestris-core
Hochperformante Erkennungs-Engine in Rust. Enthält nestris-station, den Capture-Dienst für jede Konsole, sowie Desktop- und Web-Werkzeuge.
-
nestris-terminal
Touchscreen-Kiosk: Hier melden sich Spieler an, bekommen ihre Karte, sehen ihre Platzierung und schauen Replays.
-
nestris-rfid-reader
ESP32-Firmware für den selbstgebauten Kartenleser mit RC522-RFID und OLED-Display. Spricht JSON über USB-Seriell.
Wie alles zusammenspielt¶
flowchart LR
NES["<span style='color:#f8fafc'>🎮 NES-Konsole</span>"]:::hw --> ST
CARD["<span style='color:#f8fafc'>💳 Spielerkarte</span>"]:::hw -. auflegen .-> RD1
RD1["<span style='color:#111111'>RFID-Leser</span>"]:::rfid -- USB --> ST
ST["<span style='color:#111111'>nestris-station<br/><small>nestris-core</small></span>"]:::core -- "MQTT · live + Ergebnisse" --> LTM
ST -- "HTTP · Aufzeichnung" --> LTM
LTM["<span style='color:#111111'>NestrisLTM<br/><small>Host-App + PostgreSQL</small></span>"]:::ltm -- "WebSocket" --> OUT
OUT["<span style='color:#ffffff'>📺 Overlays · Highscore · Turnierbaum</span>"]:::ext
TERM["<span style='color:#111111'>nestris-terminal<br/><small>Touch-Kiosk</small></span>"]:::term -- "REST" --> LTM
RD2["<span style='color:#111111'>RFID-Leser</span>"]:::rfid -- USB --> TERM
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
NestrisLTM nestris-core nestris-terminal nestris-rfid-reader Ausgaben / Fremdsoftware
Alle Diagramme auf dieser Seite verwenden diese Farben für dieselben Komponenten. Weiter geht's mit dem Systemüberblick oder direkt mit der Anleitung Event aufbauen.
Highlights¶
-
Liest die Konsole selbst
Klassische Bildverarbeitung, kein Machine Learning. Kalibriert sich selbst, verfolgt das Spielfeld auch bei Kamerabewegung und liefert dieselben Ergebnisse wie die ursprüngliche Python-Engine, abgesichert durch Golden-Tests.
-
Fairness eingebaut
Erkennt den Select-Score-Trick (+10 000), prüft jedes Spiel auf Plausibilität und speichert jedes Spiel framegenau als Beweis.
-
Kein Ergebnis geht verloren
Ergebnisse landen zuerst in einem Spool auf der Platte. Persistente MQTT-Sessions, At-least-once-Zustellung und Duplikaterkennung sorgen dafür, dass ein Ausfall von Station oder Netzwerk kein Spiel kostet.
-
Bereit für den Stream
Transparente 1080p-OBS-Overlays: Single, 1v1, doppeltes 1v1, 4 Spieler, Replay. Mit Live-Differenzgraph, „braucht N Tetrisse“-Anzeige und NES-getreuen Spielfeldern.
-
Turnier-Werkzeuge
Highscore-Qualifikation pro Event, K.-o.-Turnierbaum für 2–64 Spieler, Runden mit eingefrorenen Ergebnissen und Fernsteuerung per Stream Deck.
-
Signierte Updates
Releases werden mit GitHub Actions gebaut und mit Ed25519 signiert. Die Host-App sucht nach Updates, legt ein Backup an und installiert mit einem Klick.