Files
zelda-1-prometeu-port/docs/real-secret.md
T

5.2 KiB

Segredo bombável real da sala $67

A sala imediatamente ao norte do início contém o tile object $E6 em X=$70 (112), Y=$50 (80). Atributos B/F da ROM apontam para a caverna $7B, índice 17: Moblin, mensagem “IT'S A SECRET TO EVERYBODY.” e prêmio central de 30 rupias. O segredo aplica-se à primeira quest.

Como usar no jogo

  1. Obter bombas pelos drops já disponíveis; não há pacote de teste no início.
  2. Na sala norte $67, colocar a bomba junto à parede central superior.
  3. Após a explosão, caminhar pela passagem em X=112, Y=77.
  4. Dentro da caverna, tocar a rupia em X=120, Y=152 para receber 30 rupias.
  5. Sair pela abertura inferior. Link volta à passagem da sala norte.

O Moblin, a mensagem e a rupia continuam visíveis após o prêmio durante aquela visita, com o número 30 exibido; o estado seguinte não concede novamente. Na visita seguinte, o interior mostra somente os fogos. A abertura e a coleta são persistentes, inclusive ao salvar/carregar. A mensagem é exibida inteira, como na caverna inicial; revelação progressiva de diálogo continua pendente.

Organização

  • src/stages/overworld_north: dono da parede, cobertura, colisão e entrada.
  • src/stages/cave_secret: stage interna 10, terreno/colisão próprios e composição do Moblin, texto, prêmio e recibo. Reutiliza a scene de terreno 1.
  • src/stage/flow.pbs: transições e retorno; cave_origin/cave_x preservam a procedência, mantendo o comportamento anterior da caverna da espada.
  • src/inventory: crédito de 30 na fila nativa RupeesToAdd/Items[$26].
  • src/world: abertura no bit $80 e prêmio no bit $10 do byte da sala $67; os três bits de mortes permanecem independentes.

A scene base e os atlas de rolagem/inventário contêm a passagem revelada. Enquanto a flag estiver fechada, quatro glyphs opacos de pedra cobrem essa área. Render, sondas e entrada consultam o mesmo estado. A cobertura acompanha os offsets das quatro direções de scroll e do inventário. Não há troca de scene para detonar ou coletar.

O contato da bomba é estritamente menor que $10 nos dois eixos. O objeto está em Y=80; a entrada de Link é Y=77. Não confundir essas coordenadas nem usar o raio de dano $18 para abrir a parede. O primeiro slot de bomba detonando continua sendo escolhido pelo fluxo existente de Link.

Ao revelar, a ROM escreve quatro tiles $24. Ao reconstruir a sala com a flag persistente, usa o metatile secundário $0C: $F3/$24 em cada coluna. Os dois patterns são visualmente pretos, mas os IDs de colisão diferem. wall_fresh preserva essa diferença transitória; é limpo ao sair/resetar a visita.

As máscaras de prioridade da porta inicial foram reutilizadas somente após conferir os 4.352 pixels de suporte das 17 posições de entrada/saída contra o cenário real da passagem: nenhum pixel difere. Não reutilizar essa máscara em outras entradas por mera semelhança visual.

A caverna interna usa a identidade nativa da sala $67 para HUD e save, sem inserir um falso registro no histórico de inimigos. Stages 1 e 10 são interiores para a API is_cave. Não foram acrescentados slots de scene; mantêm-se 0..15.

Assets e regeneração

tools/prepare_real_secret.py extrai atributos, tipo de caverna, wares, preços, seletor/bytes de texto e descritor do Moblin. Ele acrescenta sprites no banco de caverna 3, preservando os glyphs anteriores. O Moblin usa a sobrescrita nativa de ObjAttr=$81 feita por SetUpCommonCaveObjects; usar uma entrada arbitrária da tabela de monstros pode produzir apenas metade do NPC.

tools/prepare_cave.py termina com prepare_real_secret. Depois executar tools/prepare_overworld.py para recompor terreno, cobertura e inventário. O catálogo continua com nove salas OW; a nova stage 10 é um interior. Os testes temporários da bomba e da parede sobre a espada permanecem false.

Verificações

  • tools/validate_real_secret_rom.py [caminho-do-cartao-de-teste]: metadados, máscara, 121 contatos de bomba contra a rotina 6502 e, opcionalmente, payload/checksum do cartão descartável.
  • tools/generate_real_secret_fixture.py install/restore: teste isolado de bomba real, fusível, consumo, abertura, descida, caminhada, menu, coleta, crédito, saída, bloqueio de reentrada imediata, revisita e save.
  • tools/validate_real_secret_captures.py: oito recortes comparados a pixels nativos, commit durável e releitura. Regiões de Link/efeitos vivos são explicitamente excluídas das comparações de terreno.

Foi usado somente um cartão descartável em .tmp; nunca o cartão do usuário. O payload reaberto preservou 3 bombas, 30 rupias e byte $91 da sala $67 (abertura + prêmio + uma morte registrada). Formato v1/app_id inalterados.

No build normal também foram percorridas a caverna da espada (entrada, coleta/pose e saída) e, após carregar o cartão de teste em modo somente leitura, a passagem da sala norte até a caverna já coletada, usando inputs normais. Relatórios e capturas ficam em extracted/real_secret.

Também foram reexecutadas as 18 transições do overworld, 45 comparações de mapa/HUD/inventário e seis comparações adicionais no meio das rolagens conectadas à sala norte. Todas exatas; as sondas nativas das nove salas continuam aprovadas. A fixture de overworld emite draw_objects, como o jogo.