158 lines
9.0 KiB
Markdown
158 lines
9.0 KiB
Markdown
# Vida de Link
|
||
|
||
A vida agora usa os slots originais `Items[$18]` e `Items[$19]`, e os corações
|
||
do HUD são desenhados a partir desses valores. Há dano nas duas fogueiras da
|
||
caverna, redução por anel, recuo, invulnerabilidade temporária, morte e retorno
|
||
com três corações ao pressionar Start depois de GAME OVER.
|
||
|
||
A recuperação por coração, fada e recipiente está implementada como aquisição
|
||
de itens na API. Esses objetos ainda não foram colocados no mapa nem gerados
|
||
por inimigos. Não foram adicionadas teclas de debug ao jogo normal.
|
||
|
||
## Representação e aritmética da ROM
|
||
|
||
| Dado | Representação |
|
||
| --- | --- |
|
||
| `Items[$18] / HeartValues` | Nibble alto: recipientes menos um; nibble baixo: corações inteiros |
|
||
| `Items[$19] / HeartPartial` | Fração do coração, de `$00` a `$FF` |
|
||
| `Items[$0B] / InvRing` | Grau 0, 1 ou 2; divide o dano por 1, 2 ou 4 |
|
||
| Novo jogo | `$22,$FF`: três recipientes e três corações visualmente cheios |
|
||
| Limite | 16 recipientes; as duas linhas de oito corações do HUD |
|
||
|
||
`Inventory.damage_life(amount)` recebe uma quantidade fixa de 16 bits: 256
|
||
representa um coração, 128 meio coração. Retorna 0 para pedido inválido, 1 para
|
||
dano sobrevivido e 2 para o ramo de morte da ROM. É o redutor dos bytes, sem
|
||
controlar invulnerabilidade, animação ou movimento. Atacantes devem usar
|
||
`Link.hurt(amount, attacker_x, attacker_y)`, que aplica essas regras do personagem.
|
||
|
||
`Link_BeHarmed` empresta `$FF`, não `$100`. Partindo de `$22,$FF`, dois danos de
|
||
128 deixam `$21,$FE`, e não uma fração `$FF`. Chegar exatamente a zero não aciona
|
||
a morte: o ramo de morte só é tomado quando o dano ultrapassa o saldo. Essa
|
||
regra foi preservada, incluindo a necessidade de mais um dano nesse caso.
|
||
|
||
A cura segue `TakeHeartsNoSound`: acrescenta corações inteiros mantendo a fração,
|
||
e preenche a fração quando encontra o limite de recipientes. Por isso, recuperar
|
||
um coração a partir de `$21,$7F` resulta em `$22,$7F`; uma cura seguinte preenche
|
||
`$FF`. Recipientes acrescentam `$11` a HeartValues, preservando a fração e
|
||
limitando o total a 16, como no original.
|
||
|
||
| Item ID | Efeito implementado |
|
||
| --- | --- |
|
||
| `$22` (34) | Coração: recupera um coração |
|
||
| `$23` (35) | Fada: recupera três corações |
|
||
| `$1A` (26) | Recipiente: acrescenta capacidade e um coração inteiro |
|
||
|
||
`Link.take_life_item(id)` recusa aquisição durante a morte. `Inventory` preserva
|
||
as tabelas item→slot/descritor; `take_equipment(id)` usa a classe 2 para níveis
|
||
de equipamento, incluindo os anéis, sem rebaixar o grau existente.
|
||
|
||
## Colisão e reação
|
||
|
||
`UpdateStandingFire` chama `CheckLinkCollision` na ROM. As fogueiras da caverna
|
||
estão em `(72,128)` e `(168,128)`. A colisão usa distância estritamente menor
|
||
que nove pixels em ambos os eixos; o tipo `$40` causa `$80` de dano, meio coração.
|
||
A proteção da aquisição (ação `$40`) e dos percursos automáticos é preservada.
|
||
|
||
Um contato aceito arma o contador de invulnerabilidade em `$18`. Ele é reduzido
|
||
em frames alternados, como `DecrementInvincibilityTimer`, dando aproximadamente
|
||
48 frames de proteção conforme a paridade. Link troca entre as quatro paletas
|
||
originais em vez de simplesmente desaparecer. O grau do anel também altera a
|
||
cor normal de Link. O ataque continua possível fora dos períodos de bloqueio.
|
||
|
||
O recuo tem 32 pixels, com inicialização em um frame e até quatro pixels por
|
||
frame depois dela. Consulta o terreno na grade e interrompe ao encontrar
|
||
parede ou limite. A posição é alinhada como `EnsureObjectAligned` durante o
|
||
recuo. Entre células, a escolha de eixo considera a orientação de Link; numa
|
||
interseção, esta implementação usa a maior separação ao atacante. A rotina NES
|
||
usa também o temporário `$0B`, cujo estado nem sempre é inicializado para fogo
|
||
segundo a referência consultada; a equivalência desse caso requer comparação
|
||
contra uma execução completa do NES.
|
||
|
||
## Morte e continuação
|
||
|
||
O ramo de morte mantém os recipientes, zera a vida e bloqueia comandos e cura.
|
||
A apresentação inclui o período inicial, quatro rotações, pose cinza, as duas
|
||
faíscas originais, apagamento e texto GAME OVER. Após o período de espera,
|
||
Start continua no overworld em `(120,141)`, olhando para cima, com três corações.
|
||
Inventário, recipientes e flags de itens coletados permanecem na mesma partida.
|
||
|
||
A sequência visual de morte ainda não é um port completo do modo `$11`: não
|
||
emula os fades de fundo, waits de transferência PPU nem o menu completo
|
||
CONTINUE/SAVE/RETRY. Start implementa diretamente a continuação; não há save em
|
||
disco nesta etapa. Não há áudio. Os tempos dos principais passos visuais são
|
||
explícitos em `LinkVitals`; não se afirma sincronismo global com a execução NES.
|
||
|
||
## Organização
|
||
|
||
- `src/inventory/life.pbs`: aritmética dos bytes de vida, cura e classificação
|
||
dos 16 espaços de corações; usa o mesmo array Items do inventário.
|
||
- `src/link/vitals.pbs`: imunidade, recuo e estado/apresentação da morte.
|
||
- `src/link/main.pbs`: integra os efeitos ao personagem e expõe dano/aquisição.
|
||
- `src/stages/cave_start`: fornece a colisão com as fogueiras existentes.
|
||
- `src/hud`: desenha os corações em vez de usar imagens fixas de três corações.
|
||
- `src/stage`: controla apenas o vínculo das telas de apagamento/GAME OVER.
|
||
- `src/main.pbs`: encaminha Start para continuar e conserva o fluxo normal.
|
||
|
||
Assets: HUD base no glyph slot 2, corações/fontes no slot 6, faíscas no slot 7.
|
||
Os índices 0–16 do banco HUD foram preservados; 17–19 removem apenas os corações
|
||
pré-renderizados, mantendo as bordas das caixas. As paletas adicionais dos três
|
||
bancos de Link mantêm os índices originais dos pixels. Novas scenes: 4, tela
|
||
apagada; 5, GAME OVER. Nenhum slot anterior foi renumerado.
|
||
|
||
## Regeneração e testes
|
||
|
||
```sh
|
||
python3 tools/prepare_life.py
|
||
python3 tools/validate_life_rom.py
|
||
python3 tools/validate_life_captures.py
|
||
```
|
||
|
||
`prepare_life.py` também prepara a base do HUD e preserva os IDs dos assets.
|
||
Executá-lo depois de regenerar os bancos de Link/caverna reaplica as paletas de
|
||
vida. O gerador é idempotente para as mesmas entradas e substitui os artefatos
|
||
gerados, sem editar o código do jogo.
|
||
|
||
A referência de aritmética executa uma parte limitada dos bytes 6502 da ROM:
|
||
7.392 casos de dano, incluindo anéis, e 672 de cura coincidiram com o modelo.
|
||
O código comum é mapeado de PRG `$6500` para CPU `$6C90`, conforme a rotina de
|
||
cópia; efeitos externos de EndGameMode são substituídos no ensaio, preservando
|
||
os bytes de vida e a identificação do ramo de morte. Ver `rom-validation.json`.
|
||
|
||
Um cartucho de testes temporário executou 79 casos no próprio runtime e os
|
||
estados de imunidade/morte/continuação até o frame 470. As 21 capturas completas
|
||
coincidiram pixel a pixel com posições de corações, paletas e poses esperadas.
|
||
O pixel verde no canto pertence apenas ao protocolo dessa entrada de testes;
|
||
qualquer asserção falha o tornaria vermelho de forma persistente.
|
||
|
||
A entrada é gerada por `tools/generate_life_fixture.py` em
|
||
`.tmp/life-fixture-main.pbs`. Durante o teste, `src/main.pbs` foi temporariamente
|
||
substituído, com backup em `.tmp/life-production-main.pbs`, e depois restaurado
|
||
antes do build jogável. Para repetir esse teste no Studio, é necessário fazer
|
||
a mesma troca de forma controlada e restaurar a entrada normal. O gerador não
|
||
instala a entrada automaticamente. Não confundir o cartucho de testes com o jogo.
|
||
|
||
O teste jogável usou apenas controles normais: entrada na caverna, seis contatos
|
||
válidos com a fogueira, GAME OVER e Start. A redução dos corações e o retorno
|
||
foram conferidos nas capturas. As 28 capturas anteriores de aquisição da espada
|
||
continuaram idênticas. `validation/results.json` e `validation/runs.json`
|
||
registram resultados, builds e sequência de entrada. Os validadores comparam
|
||
capturas salvas; não comandam o Studio.
|
||
|
||
Os 12 arquivos PBS envolvidos tiveram diagnostics vazios, e o build de produção
|
||
foi restaurado. Nenhuma fonte Java foi necessária.
|
||
|
||
Referências: `Link_BeHarmed`, `TakeHeartsNoSound`, `FormatHeartsInTextBuf` e
|
||
`BeginShove` em [Z_01.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_01.asm),
|
||
`UpdateStandingFire` em [Z_04.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_04.asm),
|
||
`UpdateMode11Death_Full` em [Z_05.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_05.asm),
|
||
e `DecrementInvincibilityTimer`/`Obj_Shove` em
|
||
[Z_07.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_07.asm).
|
||
|
||
Atualização do ciclo externo: a entrada jogável agora começa na abertura.
|
||
Após GAME OVER surge CONTINUE/RETRY: Select escolhe e Start confirma, seguido
|
||
por 64 ticks. Start não reinicia diretamente no estado de morte. Continue
|
||
preserva espada/coletas e restaura vida; Retry retorna ao título. Consulte
|
||
`../game_flow/README.md`. As capturas acima documentam a implementação anterior;
|
||
a nova sessão completa e suas capturas estão em `../game_flow/validation`.
|
||
Para fixtures futuras, faça backup do main atual antes da troca temporária.
|