Files
zelda-1-prometeu-port/docs/west-route.md
T

80 lines
4.3 KiB
Markdown
Raw 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.
# Percurso oeste e loja de bombas
Recorte concluído em 09/11/2026: quatro telas nativas e uma loja. O caminho
$58 → $57 → $56 → $55 → $54 → $44 termina numa fonte de bombas compráveis,
sem sorteio de drops. Há atalhos nativos $65 ↔ $55 e $64 ↔ $54.
| Stage | Sala NES | Módulo | Encontro |
|---|---|---|---|
| 12 | $56 | `overworld_west_1` | Quatro Octoroks $07 + Zora |
| 13 | $55 | `overworld_west_2` | Um Octorok $07 + Zora |
| 14 | $54 | `overworld_west_3` | Quatro Octoroks $08/$07 + Zora |
| 15 | $44 | `overworld_shop_west` | Quatro Octoroks $07; entrada aberta (64,77) |
| 16 | Interior ligado a $44 | `cave_supply_shop` | Loja $77, índice 13 |
IDs de stage são independentes dos slots de scene. A stage 16 usa a scene 1;
não foi criado um slot de scene 16. O catálogo passou a 13 salas OW, 15 ligações
reversíveis e quatro interiores. HUD, colisões, listas, flags de Zora e câmera
continuam derivados dos atributos da ROM. As salas novas não usam edge spawn.
## Compras e progressão
| Produto | ID | Slot Items | Preço |
|---|---|---|---|
| Escudo mágico | 28 | $1F | 130 |
| Pacote de quatro bombas | 0 | $01 | 20 |
| Flechas | 8 | $02 | 80 |
Comprar bombas soma quatro e limita em MaxBombs, inclusive com mochila cheia:
a ROM ainda cobra o preço. Comprar flechas preserva um grau superior já possuído.
Comprar escudo atribui 1 ao slot. Há uma compra por visita; sair e entrar repõe
os produtos. OW[$44] recebe o bit $10 sem apagar mortes; esse bit não esgota loja.
Saldo atual e pendência em Items[$27] seguem o contrato da loja anterior.
`src/shop/ShopVisit` compartilha transação, escolha e desaparecimento; cada
interior mantém seu módulo, terreno/collision data e produtos/preços próprios.
`tools/prepare_shop.py` lê os dois estoques, textos e paletas de item da ROM.
Os glyphs antigos permanecem 0–137; a loja nova acrescenta 138–171.
Item 0 tem uma particularidade: TakeItem escreve ItemTypeToLift=0 e
CheckLiftItem retorna sem erguer. Portanto comprar bombas mantém a pose normal.
Escudo e flechas usam a pose estreita de uma mão e 128 ticks. Isso foi conferido
com descritores/CHR e capturas. As flechas são propriedade do inventário;
o uso de arco/flechas ainda está pendente e a seleção B exige o arco.
Scenes de terreno/transição/inventário continuam 13/14/15. O inventário cresceu
para 16 faixas de 416 pixels, com a caverna compartilhada na variante 1.
Marcadores novos foram acrescentados de forma contígua, preservando IDs anteriores.
## Evidências
- `extracted/overworld/expansion`: 23.868 sondas nativas, 384 buscas de borda,
116 checkpoints verdes, 30 transições direcionadas e 69 comparações exatas
de cenário, marcador, inventário e destinos.
- `extracted/supply_shop`: 400 combinações nativas de compra, 150 casos da loja
anterior executados novamente, 12 comparações exatas de composição/poses,
entrada/saída real via Game.frame, menu aberto e fechado, compra única,
débito pendente, reposição e duas compras de bombas (4 → 8).
- Save durável em `.tmp/supply-shop-97ae4684.pmc`: bombas 8, flechas 1, escudo 1,
flag OW[$44]=$11 e saldo/débito 130/130 no payload v1 de 180 bytes, checksum
válido. Reabertura de 300 frames confirmou posse, reposição e liquidação 0/0.
O cartão do usuário não foi alterado.
- `regeneration.json`: prepare_cave + prepare_overworld não alteraram os hashes
dos arquivos conferidos. Fixtures são restauradas antes do build de produção.
O primeiro advance após reabrir o cartão retornou watchdog de infraestrutura
com zero frames concluídos e sem guest fault. Estado consultado; um novo advance
completou o primeiro frame e os 299 seguintes passaram. A causa permanece não
confirmada; isso não é contado como um primeiro advance aprovado.
Uma guarda com chamada no RHS de `&&` na fixture alcançou OldShopOracle.get
fora da tabela no tick 150. Foi substituída por if aninhado e toda a sequência
reexecutada. Não é falha observada de gameplay do port.
## Limites
Segredo/árvore da $56, demais entradas secundárias, uso de vela, arco/flechas e
novas famílias de inimigos ficam para outros recortes. Nenhum conteúdo nativo
foi substituído por item inicial gratuito. Testes temporários da bomba inicial
e da parede da espada continuam desligados. Save v1 e app_id preservados.