chore: version Zelda 1 port and engineering records

This commit is contained in:
Nilton Constantino
2026-11-16 15:22:13 +00:00
commit 6f2fa420c2
4282 changed files with 822198 additions and 0 deletions
+70
View File
@@ -0,0 +1,70 @@
# Loja nativa da $66
A entrada aberta da sala $66 (stage 3) leva à stage 11 `cave_shop` e retorna
à mesma sala. Tipo de caverna $78, índice 14. Coordenadas da entrada: (112,77).
Dados rastreáveis em `extracted/shop/rom-data.json`; gerador `tools/prepare_shop.py`.
| Produto | ID | Slot Items | Preço | Regra de aquisição |
|---|---|---|---|---|
| Escudo mágico | 28 | $1F | 160 | Classe 0: atribui 1, inclusive se já possuído. |
| Chave | 25 | $17 | 100 | Classe 1: soma até 255. No limite, a compra ainda custa rupias. |
| Vela azul | 6 | $04 | 60 | Classe 2: máximo entre grau atual e 1; não rebaixa vela vermelha. |
Contato com x=88/120/152 e distância vertical estrita menor que 6 em relação
a y=152. Saldo atual deve cobrir o preço; créditos futuros não contam. Um
débito pendente em Items[$27] impede outra compra. O débito é enfileirado,
não subtraído instantaneamente. Inventário concentra a transação; a stage
cuida de contato, estoque e composição. Link recebe o ID adquirido e ergue
o produto por 128 ticks, alinhado à esquerda como os itens estreitos nativos.
O bit $10 de OW[$66] é gravado preservando mortes, mas não esgota estoque
em visitas futuras. Uma compra por visita. Produto escolhido e mensagem somem;
vendedor e produtos restantes piscam por 64 ticks e desaparecem. Preços ficam.
A nova entrada reinicia a composição independentemente da flag persistente.
Terreno fixo compartilhado na scene 1; objetos/texto em sprites. Glyphs
103–137 acrescentados ao banco da caverna, mantendo IDs anteriores. Entrada,
colisão e dados ficam no módulo próprio; transições ficam em `src/stage`.
`prepare_cave.py` chama `prepare_real_secret.py`, que chama `prepare_shop.py`;
terminar regeneração com `prepare_overworld.py` para recompor o inventário.
## Evidências e limites
`validate_shop_rom.py`: 150 combinações de produto, posse prévia, saldo e débito.
Executa TakeItem/PostDebit da ROM; guardas de contato/saldo são comparadas às
regras extraídas, sem alegar emulação integral da loja. Resultado em
`extracted/shop/native-cases.json`.
`generate_shop_fixture.py install/restore`: entrada/saída real via Link/Stage,
compra, revisita, menu, três poses e save durável. Restaurar antes de entregar.
`validate_shop_captures.py`: 13 comparações exatas com CHR/descritores nativos,
incluindo poses dos três itens; exclui fogo animado, Link nas comparações do
cenário e rupia de preço piscante. A pose é comparada separadamente.
Cartão de teste isolado `.tmp/shop-fixture-21c39996.pmc`: salva os três produtos
e uma compra de vela com saldo 60/débito 60; após reabrir, asserta esse estado
e liquidação para 0/0. Sem mudar formato v1 nem cartão do usuário.
Uso da vela para fogo/árvores e portas de dungeon para chaves continuam
pendentes. Escudo mágico já participa da defesa contra Zora. Texto progressivo,
outras lojas e variantes de diálogos continuam pendentes.
A tentativa de caminhada longa do smoke de produção terminou em morte antes
da entrada: a instrumentação temporária confirmou stage 3 / modo 17. A tela
preta observada era a apresentação de morte, não falha confirmada de bind.
A fixture de compra e save não altera o cartão de uso normal.
Integração adicional: inicialização isolada na porta da $66, seguida por
`Game.frame` completo, confirmou entrada e render da loja (102 frames),
sem simular o desenho diretamente. O submenu foi aberto pelo input Start.
A fixture principal cobre fechamento com offset parcial, compra e saída;
a tentativa adicional de fechar antes do fim da abertura foi ignorada, como
previsto pela fase do submenu. Esses testes não concedem itens na produção.
## Reuso no percurso oeste
A lógica de visita/transação foi extraída para `src/shop/ShopVisit`; os 150
casos da loja $66 foram reexecutados no guest. A stage continua responsável por
seus próprios dados, produtos e composição. A loja nova da $44 tem preços
próprios; não globalizar o preço do escudo. Ver [west-route.md](west-route.md).
O gerador agora acrescenta ambas as lojas preservando os glyphs antigos.