Zum Inhalt

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 404 heiĂźt, dass der Host das game_end noch nicht verarbeitet hat; die Station versucht es erneut. Netzwerkfehler und 5xx-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