Files
zelda-1-prometeu-port/docs/overworld.md
T

4.5 KiB
Raw Blame History

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.