4.5 KiB
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. 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. 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. 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.