6.4 KiB
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, spawn/rolagem, colisão/movimento, sprites e espada. 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.