129 lines
8.1 KiB
Markdown
129 lines
8.1 KiB
Markdown
# Ciclo de combate da sala norte
|
||
|
||
Implementação sem som, mantendo os dados e regras da ROM fornecida.
|
||
|
||
- `src/world`: bytes de flags OW e histórico circular de seis salas.
|
||
- `src/enemies/octorok`: encontro, ciclo de spawn, mortos e pedras.
|
||
- `src/loot`: decisão de drops, duração, coleta e voo da fada.
|
||
- `src/link/beam.pbs`: único projétil da espada e dispersão.
|
||
- `src/combat_graphics`: composição nativa de itens, efeitos e contadores.
|
||
- `src/inventory`: quantidades, fila de rupias e vida; `src/hud` apresenta valores.
|
||
|
||
## Histórico e repopulação
|
||
|
||
Os três bits baixos do byte da sala guardam a contagem de mortos; `$07` significa
|
||
que todos foram derrotados. O bit `$10` de item coletado é preservado. O histórico
|
||
é um anel de seis inserções únicas: revisitar uma sala não a move para o fim.
|
||
Na entrada, a contagem é subtraída da população original. Uma sala com contagem
|
||
`$07` continua vazia enquanto estiver no histórico; depois de ser expulsa dele,
|
||
a contagem é limpa e a população volta. Mortes parciais continuam sendo subtraídas
|
||
mesmo quando a sala sai do histórico.
|
||
|
||
As mortes entram na contagem da visita ao terminar o efeito de morte. As flags
|
||
são gravadas na saída da sala. A morte de Link abandona as mortes ainda não
|
||
salvas dessa visita; o menu pós-morte limpa o histórico recente. Continue mantém
|
||
as flags já gravadas e o inventário. Uma nova partida limpa ambos.
|
||
|
||
A escolha de posições usa as quatro listas originais de nove células, conforme
|
||
a direção de entrada, rejeita terreno inválido e distância menor que `$22` em
|
||
ambos os eixos, e mantém SpawnCycle. A ROM calcula posições para nove slots mesmo
|
||
quando a população é menor; o coordenador faz o mesmo. As outras salas ainda
|
||
não implementadas não foram adicionadas apenas para acionar a repopulação.
|
||
|
||
## Drops e coleta
|
||
|
||
Os dados vêm de NoDropMonsterTypes, grupos, taxas e DropItemTable. O Octorok
|
||
vermelho usa o grupo 0: probabilidade `Random < $50` e ciclo de dez mortes que
|
||
seleciona coração, rupia ou fada. O contador global de mortes avança no golpe
|
||
fatal; o ciclo de drops avança depois do efeito de morte. Dez mortes sem dano
|
||
ativam o auxílio de cinco rupias, ou bombas quando a décima morte foi por bomba;
|
||
a morte número dezesseis sem dano força fada. Dano aceito em Link zera esses
|
||
contadores de ajuda, preservando o ciclo de dez. O jogo atual não oferece uso
|
||
de bombas; a regra de seleção e a quantidade coletável já estão previstas.
|
||
|
||
O objeto dura `$FF` decrementos, em frames alternados. Até o contador ficar
|
||
abaixo de `$F0`, ele pisca e não pode ser coletado. A colisão usa X de Link e
|
||
Y+3 com distância estritamente menor que 9. A espada ativa também pode coletar.
|
||
O item some ao sair da sala. Fadas voam sem colisão com terreno, com estados,
|
||
velocidade quantizada, mudanças de direção e limites do flyer da ROM.
|
||
|
||
Rupias usam Items[$26] como fila: uma é transferida para Items[$16] a cada dois
|
||
frames de atualização, com limite 255. Cinco rupias incrementam essa fila cinco
|
||
vezes, preservando o byte original. Bombas adicionam quatro até MaxBombs.
|
||
Coração e fada usam a aritmética de vida existente; fada cura três corações.
|
||
Rupias, chaves e bombas do HUD agora leem os slots reais. A formatação nativa
|
||
mantém `X0 `, `X23` ou `123`, sem alterar o HUD inicial.
|
||
|
||
## Pedra e projétil da espada
|
||
|
||
Uma pedra frontal contra o escudo de Link livre entra em ricochete. As quatro
|
||
direções leem os deslocamentos originais de ShotBounceWidths/Heights (incluindo
|
||
a sobreposição das tabelas) e terminam após distância `$20`, em 16 atualizações.
|
||
Dano traseiro continua passando por vida, recuo e imunidade. Uma pedra não
|
||
causa novo dano durante imunidade nem desaparece por esse contato ignorado.
|
||
|
||
A espada tenta criar o projétil ao passar do estado 2 para 3. Só existe um
|
||
projétil ativo, incluindo sua dispersão. O teste de vida da ROM é preservado:
|
||
nibbles de vida e capacidade iguais e fração >= `$80`, correspondente ao HUD
|
||
cheio. O disparo nasce 16px à frente, anda 3px por atualização e se dispersa
|
||
quando acerta inimigo ou chega ao limite. MoveShot não testa terreno para esse
|
||
projétil. A colisão esbelta conserva os offsets da rotina original, inclusive
|
||
a consulta à direção atual de Link. Os quatro cantos e a alternância de paletas
|
||
usam os patterns e atributos nativos. Sem vida cheia, o ataque normal continua.
|
||
|
||
## Extração e limites desta etapa
|
||
|
||
`python3 tools/prepare_combat.py` publica 30 patterns 8×8 no banco glyph 12,
|
||
extrai tabelas de drops e posições e gera as APIs de mapeamento. Odd sprite IDs
|
||
8×16 selecionam a tabela de background: o coração `$F3` usa patterns $1F20/$1F30.
|
||
O caminho de descritores de itens é executado por `nes_object_graphics.py`;
|
||
não se presume que o tile ou a paleta possam ser obtidos diretamente do ID.
|
||
A geração é idempotente. Há 13 bancos de glyph e 15 cenas, dentro dos slots atuais.
|
||
|
||
O encontro continua sendo dos Octoroks vermelhos da sala $67. Ainda não há outros
|
||
mapas, seletor de inventário, uso dos demais equipamentos, som ou save. Os slots
|
||
de objetos continuam adaptados ao encontro atual; não é uma emulação completa
|
||
do agendador NES nem uma afirmação de equivalência de todos os frames do jogo.
|
||
|
||
## Validação reproduzível
|
||
|
||
- `python3 tools/validate_combat_rom.py`: executa as rotinas 6502 originais com
|
||
um buffer de flags de teste: 240 entradas, 720 gravações e 12.800 seleções de
|
||
drops. GetRoomFlags fornece o buffer; criação de fada/destruição são fronteiras
|
||
de saída. `rom-validation.json` documenta o recorte e os endereços reais.
|
||
- `python3 tools/generate_combat_fixture.py`: produz a fixture isolada e seus
|
||
três módulos em `.tmp/combat-fixture`, sem instalá-la. Os casos vêm do oráculo
|
||
nativo. São 2.214 verificações de topo no guest, com verificações internas
|
||
adicionais de projétil, ricochete e integração das mortes. Todos passaram.
|
||
- Os casos são distribuídos em 93 frames: executá-los todos no Init excedia o
|
||
watchdog headless. Isso é propriedade do teste, não mudança no orçamento do
|
||
runtime. O frame de resultado codifica a contagem e exibe cada verificação.
|
||
- `python3 tools/validate_combat_captures.py`: quatro comparações pixel a pixel
|
||
sem diferença: HUD inicial, drops/contadores, quatro disparos/dispersões e
|
||
ricochetes em duas fases. Itens e efeitos são compostos com a CHR, paletas e
|
||
saída do código 6502. Também verifica evidências da sessão jogável.
|
||
|
||
Para repetir a fixture no Studio, adquirir o controle e fazer backup do main,
|
||
barrels e mains de Link/Octorok atuais. Instalar o main gerado; colocar o arquivo
|
||
loot-fixture no módulo loot e expor CombatFixture. Os templates de Link/Octorok
|
||
acessam estado privado: anexar seus corpos aos respectivos mains, com imports
|
||
necessários e LinkCombatChecks/EnemyCombatChecks temporariamente nos barrels.
|
||
Não deixar arquivos duplicados com as mesmas declarações. Após 93 frames, Select
|
||
alterna as duas folhas visuais. Restaurar todos os backups antes do build normal.
|
||
Os templates versionáveis ficam em `tools/fixtures/combat`.
|
||
|
||
A fixture foi removida e os mains/barrels restaurados. O build final e as
|
||
sequências exatas estão em `validation/runs.json`. Dezenove arquivos alterados
|
||
tiveram diagnostics vazios. Na sessão final, somente com controles normais:
|
||
obtenção da espada na caverna, ida ao norte, primeira morte pelo disparo, saída e
|
||
retorno para encontrar três inimigos, derrota dos restantes, coleta de coração,
|
||
aparecimento de fada e retorno à sala vazia, que continuou vazia após espera.
|
||
`validation/results.json` registra contagens reconhecidas nos sprites nativos.
|
||
Capturas anteriores da sala norte permanecem como histórico de etapas passadas.
|
||
|
||
Referências de interpretação: [histórico e gravação](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_05.asm),
|
||
[drops e ricochete](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_04.asm),
|
||
[projétil e sprites](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_07.asm),
|
||
[coleta, dano e rupias](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_01.asm).
|
||
Bytes, offsets e resultados são conferidos na ROM local; não houve consulta Java.
|