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

96 lines
5.2 KiB
Markdown

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