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
+79
View File
@@ -0,0 +1,79 @@
# 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.