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

9.0 KiB
Raw Blame History

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.