Files
zelda-1-prometeu-port/extracted/game_flow/README.md
T

3.0 KiB
Raw Blame History

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.