chore: version Zelda 1 port and engineering records
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user