94 lines
4.5 KiB
Markdown
94 lines
4.5 KiB
Markdown
# 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).
|