Files

71 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.