Files
zelda-1-prometeu-port/docs/zora.md
T

62 lines
3.5 KiB
Markdown

# Primeiro encontro com Zora
`src/enemies/zora` contém o ator $11 e a bola de fogo $55. A presença vem do
atributo A, bit $08, no catálogo `src/overworld`; a sala $65 é a única tela
atualmente portada com essa flag. Não acrescentar Zora à lista de Octoroks.
## Regras implementadas
- Candidatos de posição vêm dos bytes nativos de random: X alinhado a $10,
Y no formato $xD e tile bruto de água no intervalo $8D..$98. O byte $25
adjacente ao array Random, lido pela rotina original, é tratado explicitamente
como zero; não acessar índice 13 no array de 13 elementos.
- Estados 1..5 usam timers $20/$0F/$FF/$10/$60. Em estado 3, o tiro sai em $FD
e o timer passa a $20. Estados 1 e 5 são montículos invulneráveis; 2/3/4
expõem o ator. Frente/costas são decididas pela posição vertical de Link.
- HP equivalente a dois golpes da espada de madeira; espada, beam e bomba
consultam as APIs existentes de Link. Dano fatal produz efeito e drop
pelo grupo nativo, sem incrementar as mortes persistentes da sala.
- Submergir naturalmente permite outro surgimento. Morrer bloqueia novo Zora
nessa visita; sair e voltar reinicia o encontro. Não salvar estado transitório
do ator ou de suas bolas de fogo no memcard.
- Relógio mágico interrompe a rotina do ator; o timer geral continua a cair.
O menu pausa gameplay pela máquina GameFlow existente.
- Bola de fogo mira na posição de Link ao inicializar, usa a tabela nativa de
nove ângulos, atraso de $10 e movimento fracionário; atravessa terreno e
termina nos limites de objetos OW ($11/$E0/$4E/$CD). O dano base é meio coração.
- Escudo comum não bloqueia o tipo $55; escudo mágico em Items[$1F], com Link
idle e direção oposta, bloqueia. Tipos de tiro futuros não devem assumir
automaticamente essa mesma regra.
O encontro usa o fluxo `Enemies.update/draw`, preservando os cinco atores
existentes. Contagem de ocupação inclui atores, drops e pedras; Zora e bolas
respeitam o teto nativo de onze slots. Há seis instâncias de Fireball, suficientes
para o encontro atual; não é ainda um alocador genérico de todos os objetos NES.
## Assets e regeneração
`tools/prepare_zora.py` executa os descritores originais de Zora/fireball,
aplica os flips e acrescenta glyphs 12..18 ao banco de atores 11. Não cria
scene nem altera índices anteriores. O entrypoint de prepare_north recompõe
esse banco ao terminar. Após mudanças nas salas, usar prepare_overworld.py.
As letras, NPCs, itens e terreno continuam seguindo
[scene-composition.md](scene-composition.md). Zora é um ator sobre a scene.
## Evidências e limites
- `tools/validate_zora_rom.py`: execução 6502 delimitada de UpdateZora e
_CalcDiagonalSpeedIndex. Dois ciclos, 388 ticks, e 1.369 pares de distâncias.
Colisão/desenho/tiro externos são substituídos explicitamente por observadores;
não se trata de emulação integral do NES.
- `tools/generate_zora_fixture.py install/restore`: fixture temporária com
comparações no guest dos ciclos e verificações de água, lotação, dano,
submersão, morte/revisita, relógio e escudos. Restaurar antes da entrega.
- `tools/validate_zora_captures.py`: sete comparações de assets e doze de
composição runtime com pixels dos descritores nativos.
- Dados, capturas e resultados em `extracted/zora`.
A equivalência integral do alocador de slots, de toda ordem de atualização e
interações com armas ainda não portadas não é alegada. Não ampliar a implementação
com regras presumidas para outras famílias de inimigos.