Stage da caverna inicial
A stage @zelda1:stages/cave_start usa RoomLayoutOWCave0 da ROM local
verificada. Tem cenário e mapa de colisão próprios, conectados à abertura da
sala $77 do overworld. HUD e viewport 256×240 continuam compartilhados em 1:1.
Para entrar, caminhe para cima na abertura da parede do primeiro mapa. Para
sair, caminhe para baixo pela abertura central do piso da caverna. Link retorna
à mesma porta. Parar nessa posição não provoca reentrada: é preciso sair da
célula e voltar, preservando a regra de UndergroundExitType.
O que foi portado
- Layout e compressão das colunas da caverna, usando as tabelas do overworld.
- Paletas próprias da caverna e atributos de fundo equivalentes à sala
$44. - Colisão de terreno com os mesmos IDs e sondas NES do overworld.
- Gatilho alinhado da entrada em
(64,77); descida de 16 pixels, um pixel a cada quatro ticks, com o corpo atrás dos pixels não transparentes do cenário. - Posicionamento interno em
(112,221), olhando para cima, seguido da caminhada forçada de 48 pixels até(112,173), com a velocidade fracionária original. - Saída inferior em
Y=221; retorno a(64,93), olhando para baixo, e subida automática até(64,77)atrás do cenário, também um pixel a cada quatro ticks. - Troca do scene bank antes da emissão de HUD e personagem, sem misturar os mapas.
A primeira espada agora é coletável e Link começa sem ela. A aquisição atualiza
Items[0], apaga texto e item do piso, ergue a espada e faz o velho desaparecer.
A flag da sala impede respawn na mesma partida. Ver
inventário e primeira aquisição.
O fogo permanece estático e o texto inicial aparece inteiro. Não há diálogo progressivo ou som. As fogueiras agora causam dano; ver sistema de vida. Os waits de transferência PPU e cópia progressiva da tela NES não são emulados: o cenário é trocado de uma vez.
Organização
| Local | Responsabilidade |
|---|---|
src/stages/cave_start/ |
Vínculo do scene bank 1, terreno e condição de saída |
src/stages/overworld_start/ |
Terreno original e condição da entrada |
src/stage/flow.pbs |
Máquina de transição, posições forçadas e proteção contra reentrada |
src/stage/player_probe.pbs |
Sonda NES compartilhada, consultando a stage ativa |
src/scene/main.pbs |
Rebind da stage e câmera quando muda a tela |
src/link/ |
Aplica as posições forçadas, mantém animação e desenha o corpo |
assets/tilesets/cave_start/ |
44 glyphs 8×8, paleta de sete cores |
assets/scenes/cave_start/ |
Cena 32×30, fundo na camada 0 |
assets/characters/link_door/ |
68 poses 16×16 para prioridade atrás do cenário |
Os slots existentes foram preservados: Link 0, terreno do overworld 1 e HUD 2. Terreno da caverna ocupa glyph slot 3; poses da porta, slot 4; aquisição, slot 5. Scenes: overworld 0, caverna antes da coleta 1, com velho pós-coleta 2 e vazia 3. Link e espada continuam na camada 1; o HUD permanece na camada 0.
As poses da porta são derivadas dos sprites existentes: para cada posição e fase, pixels são tornados transparentes onde o índice original de fundo NES é diferente de zero. Isso reproduz a prioridade sprite/background nesse local, sem confundir RGB preto com transparência. Não é uma alteração dos sprites de caminhada usados durante o jogo normal.
Proveniência
room.json registra hash da ROM, colunas, mapa de IDs antes de qualquer
composição visual, paletas NES, padrões decorativos e posições do texto.
terrain.png contém apenas o terreno; room.png acrescenta a decoração estática.
room@3x.png permite inspeção sem suavização. A colisão usa o primeiro mapa,
portanto os pixels do texto e das fogueiras não se tornam paredes.
RoomLayoutOWCave0 está no offset PRG 89000. A paleta vem de
CaveBgPaletteRowsTransferBuf, offset 107101. Os atributos A/B da sala $44
selecionam, respectivamente, as linhas 3 e 2. O texto vem da primeira entrada
original de PersonTextAddrs, em PersonText; os controles de quebra de linha
são decodificados, sem redesenhar a fonte. O velho usa tile $98 espelhado,
fogueiras $5C espelhado, espada $20/$21; as posições consideram o Y visível
do OAM. RGBs continuam aproximações digitais explícitas dos códigos NES.
Rotinas de referência consultadas nos fontes locais do disassembly:
Z_05.asm
(LayoutRoomOrCaveOW, CheckWarps, HandleWarpOW, InitMode_EnterRoom,
InitMode_WalkCave, CheckCaveEdge),
Z_01.asm
(InitModeB_EnterCave_Bank5, SetUpCommonCaveObjects, tabelas de animação e texto),
e Z_07.asm
(StepOutside, GetCollidingTileMoving, PlayerScreenEdgeBounds).
Regeneração e validação
python3 tools/prepare_cave.py
python3 tools/validate_cave.py
O gerador verifica a ROM, publica os assets preservando suas identidades e
regenera somente src/stages/cave_start/room.generated.pbs. As demais fontes
PBS são mantidas manualmente. Reexecutar com as mesmas entradas é idempotente;
edições manuais nos PNGs gerados são substituídas.
O validador executa a rotina 6502 de colisão com as colunas da caverna: 2.573
sondas coincidiram com o modelo do port. Depois compara 20 capturas reais do
Studio com os cenários extraídos e os sprites em posições/fases explícitas:
zero pixels diferentes. Inclui entrada, prioridade atrás do cenário, spawn,
caminhada forçada, paredes, retorno, repouso sem reentrada e segunda visita.
Resultado: validation/results.json.
As capturas são uma sequência contínua descrita em CHECKPOINTS de
tools/validate_cave.py, começando com uma sessão nova. O script compara os PNGs
salvos; não os recaptura. Algumas posições ficam um pixel antes/depois da grade
por carry/borrow do movimento fracionário, como (65,133) e (111,173);
curvas usam as regras da grade, sem arredondar artificialmente essas posições.
As 20 capturas desta pasta registram a etapa anterior ao inventário, com
espada já disponível. A validação vigente da aquisição está em
../../inventory/validation/results.json.
Na etapa de conexão, build e pack passaram. Os 11 arquivos PBS envolvidos tiveram diagnostics vazios. Isso não equivale a comparar a execução completa com um emulador NES.