NGF-Aufzeichnungen¶
Jedes Spiel wird Frame fĂĽr Frame im NGF aufgezeichnet, dem NestrisChamps Game Format (.ngf, meist gzip-komprimiert als .ngf.gz). nestris-core schreibt die Dateien, NestrisLTM speichert und spielt sie ab, und das Terminal nutzt sie fĂĽr Spieler-Replays. Das Format ist bitkompatibel zu NestrisChamps.
flowchart LR
ENG["<span style='color:#111111'>nestris-core-Engine</span>"]:::core --> REC["<span style='color:#111111'>Recorder<br/>.ngf.part (absturzsicher)</span>"]:::core --> GZ["<span style='color:#111111'>.ngf.gz</span>"]:::core
GZ -- "HTTP PUT + X-NGF-SHA256" --> LTM["<span style='color:#111111'>NestrisLTM<br/>prüfen · speichern</span>"]:::ltm
LTM --> RP["<span style='color:#ffffff'>Replay-Viewer<br/>Admin · Terminal · Overlay</span>"]:::ext
GZ --> CLI["<span style='color:#111111'>nestris replay<br/>volle Statistik</span>"]:::core
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
Dateiaufbau¶
Eine NGF-Datei ist eine einfache Folge von Frames fester Größe, optional als Ganzes gzip-komprimiert. Leser erkennen gzip an den Magic-Bytes (1f 8b), nicht an der Dateiendung. Die obersten 3 Bits des ersten Bytes enthalten die Frame-Version:
| Version | Frame-Größe | nestris-core |
|---|---|---|
| 1 | 71 Bytes | lesen |
| 2 | 72 Bytes | lesen |
| 3 | 73 Bytes | lesen + schreiben |
Frame der Version 3 (Big Endian, bitweise gepackt)¶
| Offset | Bits | Feld |
|---|---|---|
| 0 | 3 + 2 + 3 | version, game_type (0 minimal / 1 classic / 2 DAS-Trainer), player_num |
| 1–2 | 16 | gameid |
| 3–6 | 28 + 4 | ctime (ms seit Spielstart), oberes Nibble von lines |
| 7 | 8 | unteres Byte von lines (insgesamt 12 Bit) |
| 8 | 8 | level |
| 9–11 | 24 | score |
| 12 | 5 + 3 | instant_das, Vorschau-Teil preview |
| 13 | 5 + 3 | cur_piece_das, cur_piece |
| 14–22 | 7 × 10 + 2 | Teilezähler T J Z O S L I |
| 23–72 | 200 × 2 | Spielfeld, 4 Zellen pro Byte, zeilenweise von links oben |
Teilecodes: T=0 J=1 Z=2 O=3 S=4 L=5 I=6, 7 = keines.
Upload zu NestrisLTM¶
PUT /api/stations/station-1/games/station-1-1790241008228/ngf HTTP/1.1
Authorization: Bearer nltm_…
Content-Type: application/gzip
X-NGF-SHA256: 9f86d081884c7d65…
- Upload-Aufträge überstehen Neustarts der Station. Ein
404heißt, dass der Host dasgame_endnoch nicht verarbeitet hat; die Station versucht es erneut. Netzwerkfehler und5xx-Antworten führen zu Backoff. - Der Host prüft den Hash, testet, ob sich die Datei dekodieren lässt, speichert sie und löscht die temporären Live-Frames dieses Spiels.
- Aufzeichnungen lassen sich in der Admin-Oberfläche von NestrisLTM auch importieren und exportieren, etwa um Spiele aus anderen NGF-Werkzeugen zu übernehmen.
Replay¶
| Wo | Wie |
|---|---|
| NestrisLTM-Admin | Jedes Spiel: 0,25×–8×, Spulen, Einzelbildschritte |
| Spieler-Terminal | Die eigenen Spiele, im Attract-Modus auch Replays anderer Spieler |
| OBS | Szenen-Layout replay |
| Kommandozeile | nestris replay game.ngf.gz --jsonl out.jsonl (volle Statistik) |
| Browser-GUI | Datei in die nestris-core-Web-App laden |