Files

94 lines
4.5 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.
# Expansão do overworld
O catálogo `tools/overworld_manifest.json` liga os IDs internos às salas NES.
Cada tela mantém stage, dados de colisão e render em `src/stages`; o módulo
`src/overworld` fornece metadados e conexões, e `src/stage` coordena a rolagem.
| Stage | Sala NES | Tela |
|---|---|---|
| 0 | $77 | Inicial |
| 2 | $67 | Norte |
| 3 | $66 | Noroeste |
| 4 | $65 | Noroeste 2 |
| 5 | $64 | Campo de bombas |
| 6 | $57 | Norte superior oeste |
| 7 | $58 | Norte superior leste |
| 8 | $68 | Leste da sala norte |
| 9 | $78 | Leste da sala inicial |
| 12 | $56 | Oeste 1 |
| 13 | $55 | Oeste 2 |
| 14 | $54 | Oeste 3 |
| 15 | $44 | Loja oeste |
A stage 1 continua sendo a caverna da espada. A stage 10 é a caverna secreta
da $67 (Moblin/30 rupias), acessível após bombardear a parede superior;
ver [real-secret.md](real-secret.md). O percurso novo permite
$77 → $78 → $68 → $58 → $57; $68 também liga a $67. Não há ligação direta
$67 → $57: a borda é sólida na ROM. As conexões são extraídas por adjacência
nativa e aberturas compartilhadas, sem criar portas em paredes.
As quatro salas novas usam listas nativas de Octoroks vermelhos $07/$08.
A flag de entrada pelas bordas vem do atributo F, bit 3. A busca percorre o
perímetro no sentido anti-horário, mantém o cursor entre visitas, rejeita
areia >= $84 e tenta novamente quando Link está a menos de $22 nos dois eixos.
Atores nascem em ordem descendente, sem nuvem; o atraso usa o timer longo
nativo e não repõe inimigos mortos durante a visita. O histórico de seis salas
e as flags persistentes continuam em `src/world`, com os IDs nativos.
Scenes 13, 14 e 15 continuam sendo, respectivamente, atlas de salas,
rolagens e inventário. O atlas de terreno usa quatro paletas e 35 glyphs;
o inventário possui 16 faixas. Nenhum novo slot de scene foi criado.
HUD e fundo congelado do inventário seguem a sala ativa. A área NES permanece
256×240 em escala 1:1. O save v1 e app_id permanecem os mesmos: já incluem as
128 flags do overworld. Nenhum perfil de teste deve ser escrito no cartão padrão.
## Regeneração
Executar `python3 tools/prepare_overworld.py` após regenerar assets de HUD,
salas ou inventário. Esse comando extrai as 13 salas da ROM local verificada,
recria stages gerenciadas, metadados, atlas, marcadores e inventário.
A stage inicial é mantida manualmente, incluindo os testes temporários
explicitamente desativados. Os entrypoints antigos prepare_north e
prepare_bomb_route terminam com a recomposição deste catálogo.
## Validação
`python3 tools/validate_overworld.py` executa sondas de colisão da ROM
para as 13 salas e a rotina 6502 FindNextEdgeSpawnCell para as quatro novas.
O oráculo é limitado às rotinas alcançadas, não é um emulador NES completo.
`tools/generate_overworld_fixture.py install` instala uma entrada temporária,
com cópias em `.tmp/overworld-fixture`. Compilar pelo Studio e avançar conforme
`cases.json`; capturar em `extracted/overworld/expansion/validation`.
A fixture confere as 30 transições direcionadas, nascimento dos inimigos,
limpeza/histórico e marcadores de asserção. Depois executar
`python3 tools/generate_overworld_fixture.py restore`, recompilar o jogo e
validar diagnostics. Nunca devolver a fixture instalada.
`python3 tools/validate_overworld_captures.py` compara terreno, inventário,
HUD e destinos das transições com os PNGs extraídos.
## Limites deste recorte
As cavernas, NPCs e segredos das quatro salas novas ainda não têm interação.
A paisagem e suas colisões são nativas; não substituir essas entradas por
uma cópia da caverna inicial. Outras bordas externas permanecem sem destino
até portar suas salas e tipos de inimigos.
A sala $65 possui flag de Zora, agora atendida pelo módulo
`src/enemies/zora`; detalhes em [zora.md](zora.md). As quatro
salas adicionadas não possuem essa flag. Som continua fora desta wave.
## Loja da sala $66
Entrada aberta (112,77) ligada à stage 11 `cave_shop` ($78), com retorno à $66.
Escudo mágico 160, chave 100, vela azul 60; ver [shop.md](shop.md). Continuam
nove salas OW; agora três interiores, sem novos slots de scene.
## Percurso oeste até a loja $44
Expansão $57↔$56↔$55↔$54↔$44, mais $55↔$65 e $54↔$64. Total atual:
13 salas, 15 ligações reversíveis e quatro interiores. Zora também nas salas
$56/$55/$54; $44 não possui a flag. A loja $77 é a stage 16, vinculada à 15,
com entrada aberta (64,77), bombas 20, escudo 130 e flechas 80. Nenhum slot
adicional de scene. Detalhes/limites/evidência em [west-route.md](west-route.md).