chore: version Zelda 1 port and engineering records

This commit is contained in:
Nilton Constantino
2026-11-16 15:22:13 +00:00
commit 6f2fa420c2
4282 changed files with 822198 additions and 0 deletions
+51
View File
@@ -0,0 +1,51 @@
# Abertura e ciclo principal
`src/game` coordena abertura (modo ROM 0), abertura do cenário (3), partida
(5), morte ($11) e menu (8). A entrada principal tem apenas os hooks.
As telas sem colisão ficam em `src/screens`; stages continuam donas das salas.
Start na abertura inicia sem espada, com três corações, em (120,141), voltado
para cima. O cenário abre do centro em pares de colunas de 8px a cada cinco
ticks; os controles ficam bloqueados durante os 76 ticks dessa apresentação.
Após a sequência de morte existente, o menu aparece automaticamente.
Select alterna CONTINUE/RETRY por pressão; Start confirma, tem precedência
sobre Select e inicia a espera de 64 ticks, com texto piscando.
Continue repõe vida e posição inicial, preservando inventário e flags de coleta.
Retry retorna à abertura; o próximo Start cria uma partida nova e limpa ambos.
Não há SAVE, seleção de arquivos, registro de nome, persistência, som ou
sequência automática de história nesta etapa. Portanto este é um subconjunto
do fluxo original, não a máquina inteira do cartucho.
## Extração e fidelidade
`python3 tools/prepare_game_screens.py` verifica o hash da ROM e lê seus
ponteiros reais. O diretório de transferências está no PRG 106496; título em
108788 (1121 bytes), menu em 107188, paletas do título em 38126 e OAM em 37102.
Offsets de um bins.xml de referência divergiam desta ROM; os ponteiros do
cartucho fornecido prevalecem. `rom-data.json` registra os dados usados.
Paletas NES são preservadas, com as mesmas aproximações RGB dos demais assets.
Título: patterns e atributos originais, 28 sprites estáticos, flips horizontal/
vertical, prioridade OAM, cachoeira e brilho. Oito fases de brilho compartilham
quatro cenas únicas. O menu mantém posições originais de CONTINUE e RETRY,
cursor coração e cores; SAVE e sua caixa de aviso são omitidos por não haver
armazenamento implementado. Os bancos totais usados são 10 de glyph e 13 de cena.
O viewport segue 256×240, escala 1:1, sem HUD no título/menu.
## Verificação
Build Studio `4e427901-49b3-482c-8829-94a8adea4de6` aprovado. Onze fontes PBS
consultadas por diagnostics sem ocorrências. A regeneração é idempotente; o
Studio pode reformatar o registro JSON durante o empacotamento.
`python3 tools/validate_game_flow.py` compara 37 capturas pixel a pixel: título
em diferentes clocks (inclusive 512), entrada ignorada na abertura, cortinas,
menu normal/piscando, confirmação e Select mantido, Continue com espada e
caverna coletada, Retry com nova partida e presente restaurado. Título/menu são
compostos diretamente dos patterns/paletas/OAM da ROM; salas, HUD e personagem
usam os assets previamente conferidos. Não é comparação com emulador NES.
`validation/runs.json` conserva entradas e durações das sessões reais de jogo,
sem substituir o main por fixture: aquisição, seis contatos válidos com fogo,
Continue, segunda morte, Retry e nova visita à caverna. Capturas e resultados
ficam em `validation/`. Os scripts validam capturas salvas; não controlam Studio.
+572
View File
@@ -0,0 +1,572 @@
{
"rom_sha256": "89232edf4f9b52e3cb872094bc78973de080befca2ddea893b6e936066514d4e",
"transfer_directory_prg_offset": 106496,
"title": {
"prg_offset": 108788,
"length": 1121,
"records": [
{
"address": 8192,
"control": 32,
"count": 32
},
{
"address": 8224,
"control": 32,
"count": 32
},
{
"address": 8256,
"control": 32,
"count": 32
},
{
"address": 8288,
"control": 32,
"count": 32
},
{
"address": 8320,
"control": 32,
"count": 32
},
{
"address": 8352,
"control": 32,
"count": 32
},
{
"address": 8384,
"control": 32,
"count": 32
},
{
"address": 8416,
"control": 32,
"count": 32
},
{
"address": 8448,
"control": 32,
"count": 32
},
{
"address": 8480,
"control": 32,
"count": 32
},
{
"address": 8512,
"control": 32,
"count": 32
},
{
"address": 8544,
"control": 32,
"count": 32
},
{
"address": 8576,
"control": 32,
"count": 32
},
{
"address": 8608,
"control": 32,
"count": 32
},
{
"address": 8640,
"control": 32,
"count": 32
},
{
"address": 8672,
"control": 32,
"count": 32
},
{
"address": 8704,
"control": 32,
"count": 32
},
{
"address": 8736,
"control": 32,
"count": 32
},
{
"address": 8768,
"control": 32,
"count": 32
},
{
"address": 8800,
"control": 32,
"count": 32
},
{
"address": 8832,
"control": 32,
"count": 32
},
{
"address": 8864,
"control": 32,
"count": 32
},
{
"address": 8896,
"control": 32,
"count": 32
},
{
"address": 8928,
"control": 32,
"count": 32
},
{
"address": 8960,
"control": 32,
"count": 32
},
{
"address": 8992,
"control": 32,
"count": 32
},
{
"address": 9024,
"control": 32,
"count": 32
},
{
"address": 9056,
"control": 32,
"count": 32
},
{
"address": 9088,
"control": 32,
"count": 32
},
{
"address": 9120,
"control": 32,
"count": 32
},
{
"address": 9152,
"control": 32,
"count": 32
},
{
"address": 9184,
"control": 32,
"count": 32
}
]
},
"palette_prg_offset": 38126,
"native_palettes": [
[
54,
15,
0,
16
],
[
54,
23,
39,
15
],
[
54,
8,
26,
40
],
[
54,
48,
59,
34
],
[
54,
48,
59,
22
],
[
54,
23,
39,
15
],
[
54,
8,
26,
40
],
[
54,
48,
59,
34
]
],
"glow_colors": [
39,
55,
55,
39,
23,
7,
7,
23
],
"oam_prg_offset": 37102,
"initial_oam": [
[
119,
202,
194,
208
],
[
119,
204,
194,
200
],
[
119,
202,
130,
40
],
[
119,
204,
130,
48
],
[
39,
202,
66,
208
],
[
39,
204,
66,
200
],
[
39,
202,
2,
40
],
[
39,
204,
2,
48
],
[
87,
206,
2,
116
],
[
87,
208,
2,
124
],
[
49,
210,
2,
87
],
[
79,
210,
2,
204
],
[
103,
210,
2,
123
],
[
131,
210,
2,
80
],
[
49,
212,
2,
95
],
[
63,
212,
2,
36
],
[
65,
212,
2,
100
],
[
123,
212,
2,
144
],
[
39,
214,
2,
80
],
[
43,
214,
2,
160
],
[
79,
214,
2,
44
],
[
123,
214,
2,
188
],
[
103,
160,
3,
96
],
[
103,
160,
3,
104
],
[
103,
160,
3,
112
],
[
103,
160,
3,
120
],
[
103,
160,
3,
128
],
[
103,
160,
3,
136
]
],
"sprite_glyphs": {
"160": 147,
"161": 148,
"162": 149,
"163": 150,
"164": 151,
"165": 152,
"166": 153,
"167": 154,
"168": 155,
"169": 156,
"170": 157,
"171": 158,
"172": 159,
"173": 160,
"174": 161,
"175": 162,
"176": 163,
"177": 164,
"178": 165,
"179": 166,
"180": 167,
"181": 168,
"182": 169,
"183": 170,
"184": 171,
"185": 172,
"186": 173,
"187": 174,
"188": 175,
"189": 176,
"190": 177,
"191": 178,
"192": 179,
"193": 180,
"194": 181,
"195": 182,
"196": 183,
"197": 184,
"198": 185,
"199": 186,
"200": 187,
"201": 188,
"202": 189,
"203": 190,
"204": 191,
"205": 192,
"206": 193,
"207": 194,
"208": 195,
"209": 196,
"210": 197,
"211": 198,
"212": 199,
"213": 200,
"214": 201,
"215": 202,
"242": 203,
"243": 204
},
"continue": {
"prg_offset": 107188,
"length": 170,
"records": [
{
"address": 9152,
"control": 127,
"count": 63
},
{
"address": 8364,
"control": 8,
"count": 8
},
{
"address": 8428,
"control": 4,
"count": 4
},
{
"address": 8492,
"control": 5,
"count": 5
},
{
"address": 9176,
"control": 96,
"count": 32
},
{
"address": 8579,
"control": 1,
"count": 1
},
{
"address": 8580,
"control": 88,
"count": 24
},
{
"address": 8604,
"control": 1,
"count": 1
},
{
"address": 8611,
"control": 203,
"count": 11
},
{
"address": 8636,
"control": 203,
"count": 11
},
{
"address": 8963,
"control": 1,
"count": 1
},
{
"address": 8964,
"control": 88,
"count": 24
},
{
"address": 8988,
"control": 1,
"count": 1
},
{
"address": 8652,
"control": 7,
"count": 7
},
{
"address": 8709,
"control": 22,
"count": 22
},
{
"address": 8773,
"control": 22,
"count": 22
},
{
"address": 8837,
"control": 22,
"count": 22
},
{
"address": 8901,
"control": 15,
"count": 15
}
]
},
"continue_cursor_glyph": 10,
"continue_label_addresses": [
8364,
8492
],
"continue_cursor_data": [
243,
2,
80,
39,
55,
71
],
"scope": "Title scene, native glow/waterfall/OAM and reduced CONTINUE/RETRY menu. Save slots, registration and save not in this iteration."
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

+153
View File
@@ -0,0 +1,153 @@
{
"pixel_comparisons": [
{
"capture": "title_6",
"different_pixels": 0
},
{
"capture": "title_7",
"different_pixels": 0
},
{
"capture": "title_8",
"different_pixels": 0
},
{
"capture": "title_13",
"different_pixels": 0
},
{
"capture": "title_25",
"different_pixels": 0
},
{
"capture": "title_31",
"different_pixels": 0
},
{
"capture": "title_43",
"different_pixels": 0
},
{
"capture": "title_58",
"different_pixels": 0
},
{
"capture": "title_59",
"different_pixels": 0
},
{
"capture": "title_64",
"different_pixels": 0
},
{
"capture": "title_512",
"different_pixels": 0
},
{
"capture": "title_first",
"different_pixels": 0
},
{
"capture": "title_ignored_controls",
"different_pixels": 0
},
{
"capture": "play_title",
"different_pixels": 0
},
{
"capture": "return_title",
"different_pixels": 0
},
{
"capture": "title_after_retry",
"different_pixels": 0
},
{
"capture": "continue_menu",
"different_pixels": 0
},
{
"capture": "confirm_continue",
"different_pixels": 0
},
{
"capture": "continue_flash",
"different_pixels": 0
},
{
"capture": "continue_wait_last",
"different_pixels": 0
},
{
"capture": "retry_menu",
"different_pixels": 0
},
{
"capture": "select_retry",
"different_pixels": 0
},
{
"capture": "hold_select",
"different_pixels": 0
},
{
"capture": "confirm_retry",
"different_pixels": 0
},
{
"capture": "retry_flash",
"different_pixels": 0
},
{
"capture": "unfurl_first",
"different_pixels": 0
},
{
"capture": "unfurl_mid",
"different_pixels": 0
},
{
"capture": "unfurl_ready",
"different_pixels": 0
},
{
"capture": "new_game_curtain",
"different_pixels": 0
},
{
"capture": "new_game_ready",
"different_pixels": 0
},
{
"capture": "continue_curtain",
"different_pixels": 0
},
{
"capture": "continue_ready",
"different_pixels": 0
},
{
"capture": "retry_new_curtain",
"different_pixels": 0
},
{
"capture": "retry_new_ready",
"different_pixels": 0
},
{
"capture": "cave_ready",
"different_pixels": 0
},
{
"capture": "cave_owned_again",
"different_pixels": 0
},
{
"capture": "new_game_cave",
"different_pixels": 0
}
],
"scope": "Saved Studio captures; independent ROM title/menu composition, gameplay composition from previously verified assets. No complete NES emulator equivalence claim."
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

+497
View File
@@ -0,0 +1,497 @@
{
"title": [
[
"title_first",
1,
{}
],
[
"title_6",
5,
{}
],
[
"title_7",
1,
{}
],
[
"title_8",
1,
{}
],
[
"title_13",
5,
{}
],
[
"title_25",
12,
{}
],
[
"title_31",
6,
{}
],
[
"title_43",
12,
{}
],
[
"title_58",
15,
{}
],
[
"title_59",
1,
{}
],
[
"title_64",
5,
{}
],
[
"title_512",
448,
{}
],
[
"title_ignored_controls",
30,
{
"up": true,
"a": true
}
],
[
"unfurl_first",
1,
{
"start": true,
"right": true,
"a": true
}
],
[
"unfurl_mid",
35,
{
"start": true,
"right": true,
"a": true
}
],
[
"unfurl_ready",
41,
{
"start": true,
"right": true,
"a": true
}
],
[
"first_play_move",
1,
{
"start": true,
"right": true,
"a": true
}
],
[
"released",
1,
{}
],
[
"unarmed_attack_ignored",
5,
{
"a": true
}
]
],
"play": [
[
"play_title",
1,
{}
],
[
"new_game_curtain",
1,
{
"start": true
}
],
[
"new_game_ready",
76,
{}
],
[
"approach_left",
40,
{
"left": true
}
],
[
"approach_up",
49,
{
"up": true
}
],
[
"cave_ready",
96,
{}
],
[
"align_sword",
6,
{
"right": true
}
],
[
"pickup",
11,
{
"up": true
}
],
[
"sword_owned",
128,
{}
],
[
"align_fire",
35,
{
"left": true
}
],
[
"fire_boundary",
16,
{
"up": true
}
],
[
"first_damage",
1,
{
"up": true
}
],
[
"wait_immunity",
60,
{}
],
[
"death1_hit_2",
30,
{
"up": true
}
],
[
"death1_wait_2",
60,
{}
],
[
"death1_hit_3",
30,
{
"up": true
}
],
[
"death1_wait_3",
60,
{}
],
[
"death1_hit_4",
30,
{
"up": true
}
],
[
"death1_wait_4",
60,
{}
],
[
"death1_hit_5",
30,
{
"up": true
}
],
[
"death1_wait_5",
60,
{}
],
[
"death1_hit_6",
30,
{
"up": true
}
],
[
"death1_wait_6",
60,
{}
],
[
"continue_menu",
300,
{}
],
[
"confirm_continue",
1,
{
"start": true
}
],
[
"continue_flash",
59,
{
"start": true,
"select": true,
"right": true,
"a": true
}
],
[
"continue_wait_last",
4,
{
"start": true,
"select": true,
"right": true,
"a": true
}
],
[
"continue_curtain",
1,
{
"start": true,
"select": true,
"right": true,
"a": true
}
],
[
"continue_ready",
76,
{
"start": true,
"select": true,
"right": true,
"a": true
}
],
[
"continue_release",
1,
{}
],
[
"continue_left",
40,
{
"left": true
}
],
[
"continue_up",
49,
{
"up": true
}
],
[
"cave_owned_again",
96,
{}
],
[
"retry_align_fire",
29,
{
"left": true
}
],
[
"retry_first_damage",
28,
{
"up": true
}
],
[
"retry_immunity",
60,
{}
],
[
"death2_hit_2",
30,
{
"up": true
}
],
[
"death2_wait_2",
60,
{}
],
[
"death2_hit_3",
30,
{
"up": true
}
],
[
"death2_wait_3",
60,
{}
],
[
"death2_hit_4",
30,
{
"up": true
}
],
[
"death2_wait_4",
60,
{}
],
[
"death2_hit_5",
30,
{
"up": true
}
],
[
"death2_wait_5",
60,
{}
],
[
"death2_hit_6",
30,
{
"up": true
}
],
[
"death2_wait_6",
60,
{}
],
[
"retry_menu",
300,
{}
],
[
"select_retry",
1,
{
"select": true
}
],
[
"hold_select",
30,
{
"select": true
}
],
[
"confirm_retry",
1,
{
"start": true
}
],
[
"retry_flash",
59,
{
"start": true,
"select": true
}
],
[
"return_title",
5,
{
"start": true,
"select": true
}
],
[
"title_after_retry",
1,
{}
],
[
"retry_new_curtain",
1,
{
"start": true
}
],
[
"retry_new_ready",
76,
{}
],
[
"retry_left",
40,
{
"left": true
}
],
[
"retry_up",
49,
{
"up": true
}
],
[
"new_game_cave",
96,
{}
]
],
"build": "4e427901-49b3-482c-8829-94a8adea4de6"
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB