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
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,
UpdateStandingFire em Z_04.asm,
UpdateMode11Death_Full em Z_05.asm,
e DecrementInvincibilityTimer/Obj_Shove em
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.