52 lines
3.0 KiB
Markdown
52 lines
3.0 KiB
Markdown
# 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.
|