Zum Inhalt

Ablauf eines Spiels

Diese Seite verfolgt ein Spiel durch das ganze System: von der Karte am Leser bis zum Endergebnis in der Datenbank und der Aufzeichnung, die es belegt.

Ablauf

sequenceDiagram
    autonumber
    actor P as Spieler
    participant R as RFID-Leser
    participant S as nestris-station
    participant B as Mosquitto
    participant L as NestrisLTM
    participant D as PostgreSQL
    participant O as Overlay / Anzeige

    P->>R: legt Karte auf
    R->>S: card present (uid, name)
    S->>B: player (retained)
    B->>L: player
    L->>B: cmd show (Platz, Bestwert)
    B->>S: cmd
    S->>R: show
    R-->>P: OLED zeigt Nickname, Platz, Bestwert

    P->>S: startet ein Spiel am NES
    Note over S: Engine erkennt den Spielbildschirm<br/>(nach min_game_frames)
    S->>B: event/game_start (ausfallsicher)
    B->>L: game_start
    L->>D: Spiel anlegen (idempotent ĂĽber game_id)

    loop jedes NES-Frame (bis 60 Hz)
        S->>B: live · Score, Lines, Level, Spielfeld
        B->>L: live
        L->>O: WebSocket-Push
    end

    opt Select-Score-Trick erkannt
        S->>B: event/cheat (ausfallsicher)
        B->>L: cheat → Spiel markiert
    end

    Note over S: Game Over / Reset / Signal weg
    S->>B: event/game_end (ausfallsicher, Ergebnis + PrĂĽfung)
    B->>L: game_end
    L->>D: Ergebnis speichern
    L->>O: Highscore / Runde aktualisieren
    S->>L: HTTP PUT …/games/{game_id}/ngf (gzip-Aufzeichnung)
    L->>D: Aufzeichnung speichern, temporäre Live-Frames löschen

Schritt fĂĽr Schritt

  1. Erkennen. Der Leser meldet die Karte in rund 300 ms. Die Station veröffentlicht den Spieler als retained-MQTT-Nachricht, damit jeder neue Empfänger weiß, wer an der Station spielt.
  2. BegrĂĽĂźen. NestrisLTM sucht den Spieler heraus und schickt ĂĽber die Station einen show-Befehl zurĂĽck. Das OLED des Lesers zeigt Nickname, aktuelle Platzierung und Bestwert.
  3. Start. Sobald die Engine genug Spiel-Frames gesehen hat, sendet die Station event/game_start. Die Spiel-ID besteht aus Stations-ID und Zeitstempel, zum Beispiel station-1-1790241008228.
  4. Live. Jede Änderung geht über live hinaus, bis zu einmal pro NES-Frame. Die Overlays bekommen sie per WebSocket und zeichnen das Spielfeld in den originalen Level-Farben.
  5. Integrität. Jeder Punktezuwachs wird gegen die NES-Wertungsregeln geprüft. Pauschal +10 000 ohne passende Reihen sind der Select-Trick und werden als event/cheat gemeldet. Das Spiel zählt weiter, trägt aber eine Markierung.
  6. Ende. Bei Game Over, Konsolen-Reset, Signalverlust oder Herunterfahren sendet die Station event/game_end. Es enthält Endscore, Lines, Level, Anzahl der Abräumarten, Tetris-Rate, Burn, Drought, Teile und einen Prüfblock.
  7. Beweis. Die Station lädt die vollständige Aufzeichnung hoch (.ngf.gz, jedes Frame). NestrisLTM prüft sie, speichert sie und verwirft die temporären Live-Frames. Ab jetzt lässt sich das Spiel in der Admin-Oberfläche oder am Terminal als Replay ansehen.

Zuverlässigkeitsgarantien

Ausfall Was passiert
Netzwerk oder Broker fällt während eines Spiels aus Ausfallsichere Ereignisse bleiben im Spool der Station auf der Platte und werden erneut gesendet, bis der Broker sie bestätigt (PUBACK).
Host wird mitten im Turnier neu gestartet Persistente MQTT-Session plus Mosquitto-Persistenz: wartende Ergebnisse kommen an, sobald der Host wieder läuft.
Doppelte Zustellung Der Host erkennt Duplikate über game_id und Topic; Schreibvorgänge sind idempotent.
Capture-Stick abgesteckt Die Station meldet waiting_for_device und macht automatisch weiter.
30 s kein Bild mitten im Spiel Das Spiel wird mit end_reason: signal_lost abgeschlossen.
Station stürzt ab systemd startet sie in Sekunden neu, ein Watchdog fängt eine hängende Hauptschleife ab.
Upload der Aufzeichnung schlägt fehl Upload-Aufträge überstehen Neustarts und werden mit Backoff bis zu 48 h lang wiederholt.

PrĂĽfcodes

Jedes game_end enthält valid: true|false und eine Liste von Befunden. Fehler markieren ein Spiel zur Prüfung, Warnungen sind nur Hinweise.

Code Schwere Bedeutung
partial_game Fehler Erfassung ist in ein bereits laufendes Spiel eingestiegen
score_reconcile Fehler Endscore passt nicht zu den erkannten Abräumungen plus Cheats
lines_clears_mismatch Fehler Die Abräumungen ergeben nicht die gespielten Lines
value_range Fehler Unmöglicher Wert (zum Beispiel Level > 255)
engine_restart Fehler Engine wurde mitten im Spiel neu aufgebaut
signal_lost Warnung / Fehler Kein brauchbares Bild (ab 2 s Warnung, ab 10 s Fehler)
low_confidence Warnung / Fehler Zu viele Frames mit geringer Erkennungssicherheit
level_mismatch Warnung Endlevel passt nicht zum NES-Levelverlauf
level_score_mismatch Warnung Level-Ziffer vermutlich falsch gelesen; der Score selbst ist stimmig
score_unexplained Warnung Punktezuwächse, die zu keinem Wertungsereignis passen
plausibility_corrections Warnung Viele verworfene Messwerte im Spiel