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

103 lines
6.4 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.
# Sala norte $67 e primeiro encontro
Stage própria em `src/stages/overworld_north`; inimigos em `src/enemies/octorok`.
A sala inicial $77 está ligada à $67 nos dois sentidos. Subir pelo corredor
central inicia a rolagem; descer pela abertura inferior retorna. A stage mantém
seus tiles NES e colisões. O compositor usa uma cena vertical combinada para a
rolagem (8px a cada dois ticks, 44 ticks), com controles bloqueados. O HUD fica
fixo na camada 2, acima do cenário e dos personagens da camada 1; o marcador do
minimapa acompanha a sala. As esperas de cópia PPU não são simuladas.
`python3 tools/prepare_north.py` extrai a sala do cartucho verificado, publica
bancos e gera colisões. A extração da sala inicial continua sendo o default de
`extract_start_room.py`. Os novos slots são glyph 10/11 e scene 13/14; há 12
bancos glyph e 15 cenas no total, respeitando o limite atual de 16 por tipo.
O gerador preserva as identidades e é idempotente, inclusive no registro JSON.
## Dados da ROM
Atributos da sala: `72 86 47 62 64 40`; layout `$62`; objeto `$07`, quatro
Octoroks vermelhos lentos (C=$47, índice de quantidade 1 → 4). A lista de spawn
para entrada subindo é lida em PRG 83561; após rejeitar terreno bloqueado, as
primeiras posições válidas são (80,93), (80,157), (96,125), (128,141).
Frames: DrawObjectWithType incrementa o tipo: ObjAnimations[$08] → heap $1B,
tiles `B4 B0 B0 B8 B2 B2`.
Dois frames de caminhada, seis ticks cada; direita espelha esquerda e poses
verticais usam metades espelhadas; para cima também aplica flip vertical
indicado por atributos $82/$C2. A pedra ($53) usa animação $54, tile $9E,
meia largura, posição X+4. O tipo não pode indexar ObjAnimations diretamente. Nuvens usam $70/$72/$74
com paleta azul: esses patterns permanecem do bloco de demo carregado na abertura,
antes de o bloco OW sobrescrever somente a partir de $08E0. O script preserva
essa ordem de carga. Não se deve deixar o intervalo $0700–$08DF zerado.
A rotina usa QSpeed $20 (meio pixel/tick), fração de oito bits, alinhamento de
16px, turn rate $70, seleção de alternativas ao encontrar paredes e intenção de
tiro quando alinha com Link. O registro aleatório de 13 bytes segue a rotação
com feedback da ROM; seu estado inicial e fase ainda não reproduzem um power-on
completo do NES. O disparo usa condição aleatória de Octorok vermelho e pausa
$30, liberando pedra em $10; velocidade da pedra: 3px/tick. Limites de monstros:
$11/$E0/$4E/$CD, distintos dos limites de transição do jogador.
Contato e pedra causam meio coração ($80) pelo sistema existente de vida,
recuo e imunidade. Escudo comum bloqueia pedra quando Link está livre e voltado
contra ela. A espada só atinge no estado 2, com limiares $0C/$10 conforme o eixo;
um golpe da espada de madeira mata o Octorok vermelho (HP $10).
O ciclo de combate foi complementado: histórico circular de seis salas, contagem
de mortos nas flags, SpawnCycle, drops/coleta, ricochete e projétil da espada.
Consulte `../../combat/README.md` para regras, recortes e validação atualizados.
Continuam pendentes outras salas/inimigos, agendador completo de slots, seletor
de inventário, uso de outros equipamentos, som e persistência em disco.
## Validação
`python3 tools/validate_north.py`: 1.836 sondas do jogador e 1.836 dos inimigos
comparadas com a rotina 6502 real GetCollidingTileMoving, sem divergências.
A mesma rotina usa duas colunas nas sondas verticais para ambos; o offset
negativo é -8 no jogador e -16 nos demais objetos. A matriz gerada contém os
704 tiles originais. Três capturas completas de nuvens/encontro são compostas
com patterns e paletas da ROM e comparadas pixel a pixel, sem diferenças.
`tools/generate_north_fixture.py` gera 32 asserções PBS: transições, bloqueio de
controles, quatro inimigos, nascimento, velocidade, tiro, escudo frontal,
dano traseiro, imunidade, estado/alcance da espada, morte e retorno. O gerador
não instala a fixture. O teste foi instalado temporariamente, passou com 32
células verdes e teve main/barrel restaurados e arquivo de fixture removido.
Para repetir, fazer backup do main/barrel atuais, instalar os arquivos gerados
em `.tmp/north-fixture`, expor EnemyFixture no barrel apenas durante o teste,
e restaurar tudo antes do build de produção.
O build final, protocolo de entradas e IDs de builds estão em
`validation/runs.json`; as capturas e resultados ficam no mesmo diretório.
Diagnostics das fontes alteradas ficaram vazios. A regressão da sala inicial
passou com 2.573 sondas; as 37 capturas históricas do ciclo externo continuam
passando no respectivo validador (isso não significa reexecutar aquela sessão).
Referências de interpretação: [rotinas Octorok/tiro](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_04.asm),
[spawn/rolagem](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_05.asm),
[colisão/movimento](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_07.asm),
[sprites e espada](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_01.asm).
Os offsets e bytes vêm da ROM local; o disassembly é referência de interpretação.
## Correção dos gráficos de Octorok e pedra
A primeira implementação usava tipo diretamente como índice de animação e
omitira o flip vertical. Isso selecionava frames de outro objeto e tile $98
para a pedra (uma metade de personagem). A comparação visual anterior repetia
a mesma suposição para os Octoroks e não tinha uma pedra visível nas capturas:
era uma validação insuficiente da interpretação dos dados, apesar de comparar
pixels. Capturas antigas permanecem como histórico, não como referência correta.
Agora `tools/nes_object_graphics.py` executa as instruções 6502 originais do
caminho DrawObjectWithType até Anim_WriteSpritePair, incluindo o INY, tabela de
atributos, troca de metades, flips e flag de meia largura. A extração usa seus
descritores e `tools/validate_octorok_graphics.py` confere os oito frames e uma
pedra realmente visível no Studio. Esperados fixos adicionais ancoram índices,
tiles e flip vertical corretos, evitando aceitar novamente o deslocamento errado.
Fixture, capturas, preview e resultados estão em `validation/graphics_fix`.
A entrada normal foi restaurada antes do build final. O resultado do build e
protocolo desta correção ficam em `validation/graphics_fix/runs.json`.
`validate_north.py` usa novas capturas `fixed_*`, não as anteriores defeituosas.