chore: version Zelda 1 port and engineering records
@@ -0,0 +1,44 @@
|
||||
# Zelda 1 — save format v1
|
||||
|
||||
One memcard slot under stable `app_id = 2137977836`. Manifest app version may
|
||||
change independently of the payload schema. Payload is exactly 180 bytes:
|
||||
|
||||
| Offset | Size | Meaning |
|
||||
|---|---:|---|
|
||||
| 0 | 4 | ASCII ZL1S |
|
||||
| 4 | 1 | Schema version, 1 |
|
||||
| 5 | 1 | Reserved, 0 |
|
||||
| 6 | 2 | Payload length, 168, little endian |
|
||||
| 8 | 4 | Adler-32: A then B, each uint16 little endian |
|
||||
| 12 | 40 | Native Items block |
|
||||
| 52 | 128 | Native overworld room flags |
|
||||
|
||||
Adler starts at A=1, B=0, modulus 65521; it covers bytes 4..7 and 12..179 in
|
||||
order. Magic, length, schema, checksum and important inventory ranges are
|
||||
checked before any live state changes. Runtime CRC/generation remain owned
|
||||
by memcard. No raw save state, native pointers or host paths enter the payload.
|
||||
|
||||
Items are captured as-is; on load the temporary clock (slot $15) is cleared,
|
||||
life is normalized to three full hearts (capped by capacity), B selection is
|
||||
reset, and the player starts at the original overworld spawn. Enemies, shots,
|
||||
loot, timers and room-history ring are rebuilt.
|
||||
|
||||
Room bytes are preserved whole, including prior recorded kill counts. This
|
||||
matches the original save copying WorldFlags, rather than masking all kills.
|
||||
The six-room history is not persisted: a saved $07 clear flag resets on a
|
||||
later visit outside that history, while partial counts follow the native
|
||||
rule. Item flag $10 and discovered-secret flag $80 stay independent.
|
||||
|
||||
Only overworld flags are currently modeled. Dungeon flag banks, player names,
|
||||
death count, quest selection and three profiles are future schema work; they
|
||||
are not silently represented by zeroed fictitious data.
|
||||
|
||||
Save flow: slot_write changes admitted RAM; slot_commit submits a frozen
|
||||
request; Frame polls query and releases the terminal result. Only state 1
|
||||
produces GAME SAVED. State 4 is MEMORY ONLY / NOT SAVED TO CARD. Failure and
|
||||
indeterminate results retain distinct screens. Runtime owns media, dirty
|
||||
session choices, deadlines, reconciliation and publication recovery.
|
||||
|
||||
Invalid or unsupported payloads stay on the card and are not applied. A fresh
|
||||
in-memory game does not delete the prior saved slot; choosing Save explicitly
|
||||
replaces that one slot. There is no autosave on pause, room change or exit.
|
||||
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 16 KiB |
@@ -0,0 +1 @@
|
||||
b90a13e2450e1ce61a80c9f77b90cb9128b367c6cb4ba60a7c138b85c9bae24a
|
||||
@@ -0,0 +1 @@
|
||||
d3fd9304ae41b5af8035bf40973026021c13d136c8ebef711f63ac49f643598c
|
||||
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 14 KiB |
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"checksum": 3656779406,
|
||||
"checksum_bytes": [
|
||||
142,
|
||||
6,
|
||||
246,
|
||||
217
|
||||
],
|
||||
"length": 180
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"persistent_read_only_boot": "runtime refused before game admission with read_only",
|
||||
"read_only_existing_memory_boot": "admitted; save blocked in game",
|
||||
"read_only_file_hash_unchanged": true,
|
||||
"memory_fresh_commit_state": 4,
|
||||
"game_display": "MEMORY ONLY / NOT SAVED TO CARD",
|
||||
"test_memory_discard": "explicit, own fixture data only"
|
||||
}
|
||||
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 15 KiB |
@@ -0,0 +1,31 @@
|
||||
{
|
||||
"payload_bytes_compared": 180,
|
||||
"independent_adler32": true,
|
||||
"separate_process_roundtrip": true,
|
||||
"byte_sentinels": [
|
||||
0,
|
||||
127,
|
||||
128,
|
||||
255
|
||||
],
|
||||
"memory_only_not_durable": true,
|
||||
"read_only_blocked": true,
|
||||
"invalid_magic_preserved": true,
|
||||
"unknown_schema_preserved": true,
|
||||
"truncated_payload_preserved": true,
|
||||
"native_ui_pixel_comparisons": 2,
|
||||
"different_pixels": 0,
|
||||
"scope": "Isolated guest fixtures and SDK processes; no power-loss fault injection or full NES emulation claim.",
|
||||
"production_build": "1185eafc-54ce-4d8e-8299-b0508047e748",
|
||||
"production_build_status": "SUCCESS",
|
||||
"diagnostics_files": 12,
|
||||
"diagnostics": [],
|
||||
"fixture_removed": true,
|
||||
"default_memcard": ".studio/memcard.pmc",
|
||||
"default_card_has_test_profile": false,
|
||||
"stable_app_id": 2137977836,
|
||||
"project_version": "1.0.0",
|
||||
"project_version_upgrade_test": "1.0.0 to 1.0.1 with same app_id",
|
||||
"normal_pad_flow": "title, new game, live menu, save, durable confirmation, shutdown, new process, continue",
|
||||
"save_ui_generator_idempotent_files": 49
|
||||
}
|
||||
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 14 KiB |
@@ -0,0 +1,19 @@
|
||||
{
|
||||
"payload_bytes_compared": 180,
|
||||
"independent_adler32": true,
|
||||
"separate_process_roundtrip": true,
|
||||
"byte_sentinels": [
|
||||
0,
|
||||
127,
|
||||
128,
|
||||
255
|
||||
],
|
||||
"memory_only_not_durable": true,
|
||||
"read_only_blocked": true,
|
||||
"invalid_magic_preserved": true,
|
||||
"unknown_schema_preserved": true,
|
||||
"truncated_payload_preserved": true,
|
||||
"native_ui_pixel_comparisons": 2,
|
||||
"different_pixels": 0,
|
||||
"scope": "Isolated guest fixtures and SDK processes; no power-loss fault injection or full NES emulation claim."
|
||||
}
|
||||
|
After Width: | Height: | Size: 60 KiB |