103 lines
6.4 KiB
Markdown
103 lines
6.4 KiB
Markdown
# 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.
|