Zum Inhalt

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.

Los geht's Downloads GitHub

Animiertes NES-Tetris-Spielfeld

60 HzLive-Spielfeld und Score pro Station
~3 msErkennungszeit pro Videobild
0 TippenScores werden vom Bildschirm gelesen und automatisch gewertet
100 %offline: alles läuft im Event-LAN

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.

    Mehr erfahren · Release

  • nestris-core


    Hochperformante Erkennungs-Engine in Rust. Enthält nestris-station, den Capture-Dienst für jede Konsole, sowie Desktop- und Web-Werkzeuge.

    Mehr erfahren · Release

  • nestris-terminal


    Touchscreen-Kiosk: Hier melden sich Spieler an, bekommen ihre Karte, sehen ihre Platzierung und schauen Replays.

    Mehr erfahren · Release

  • nestris-rfid-reader


    ESP32-Firmware für den selbstgebauten Kartenleser mit RC522-RFID und OLED-Display. Spricht JSON über USB-Seriell.

    Mehr erfahren · Release

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.