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¶
- 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.
- 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. - 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 Beispielstation-1-1790241008228. - Live. Jede Änderung geht über
livehinaus, bis zu einmal pro NES-Frame. Die Overlays bekommen sie per WebSocket und zeichnen das Spielfeld in den originalen Level-Farben. - 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/cheatgemeldet. Das Spiel zählt weiter, trägt aber eine Markierung. - 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. - 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 |