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

52 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.