# 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](../../inventory/README.md). 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](../../life/README.md). 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](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_05.asm) (`LayoutRoomOrCaveOW`, `CheckWarps`, `HandleWarpOW`, `InitMode_EnterRoom`, `InitMode_WalkCave`, `CheckCaveEdge`), [Z_01.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_01.asm) (`InitModeB_EnterCave_Bank5`, `SetUpCommonCaveObjects`, tabelas de animação e texto), e [Z_07.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_07.asm) (`StepOutside`, `GetCollidingTileMoving`, `PlayerScreenEdgeBounds`). ## Regeneração e validação ```sh 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.