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

129 lines
8.1 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.
# 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.