# 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.