Zum Inhalt

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?