# Primeira stage do overworld Sala `$77` da primeira campanha, extraída da ROM local verificada. O layout usado é `$72`. A entrega cobre somente o terreno: pedras, chão, caminhos e entrada da caverna. `room.png` preserva a faixa superior preta como fonte de terreno; o jogo desenha nessa faixa o [HUD compartilhado](../../hud/README.md). Há colisão de terreno e conexão de ida e volta com a [caverna inicial](../../cave/start/README.md). Inimigos e outras salas ainda não estão implementados. O controle e o ataque de Link continuam disponíveis para inspecionar o render. A posição de teste anterior de Link foi mantida; esta etapa não implementa a sequência de entrada do jogo nem o inventário inicial da ROM. ## Dados extraídos - `room.png`: composição 256×240 com a área do HUD reservada. - `room@3x.png`: ampliação sem suavização para inspeção. - `tiles/`: os 21 padrões 8×8 com a paleta usada nesta sala. - `room.json`: mapa de tiles, paletas NES, descritores e bytes comprimidos de cada coluna, offsets PRG e hash da ROM. - `runtime_initial.png`: captura real do cenário no Prometeu, dentro da caixa. - `runtime_no_collision_left.png`: registro histórico anterior às colisões. - `runtime_attack_over_terrain.png`: corpo e espada acima do cenário. - `runtime-validation.json`: resultado das três comparações pixel a pixel. ## Decodificação A identificação da sala vem de `LevelInfoOW`, no offset PRG `103215`. O atributo D da sala seleciona o layout `$72` na tabela `RoomLayoutsOW`. Cada um dos 16 descritores de coluna seleciona um grupo e uma coluna comprimida. Os bytes de cada coluna produzem 11 blocos de 16×16; o bit `$40` repete um bloco. Os blocos selecionam quatro padrões 8×8 pelas tabelas Primary/SecondarySquaresOW. Os padrões de fundo são reconstruídos com os blocos CommonBackgroundPatterns, PatternBlockOWBG e CommonMiscPatterns. As paletas externa e interna desta sala selecionam a mesma linha NES 2: `$0F, $1A, $37, $12`. Os códigos são originais; os RGBs são aproximações digitais explícitas, seguindo o critério usado nos assets de Link. Não há uma captura de PPU/emulador NES usada como referência de saída RGB neste teste. Referências de formato e algoritmo: [Z_05.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_05.asm) (LayoutRoomOW, WriteSquareOW, FillPlayAreaAttrs) e [Z_06.asm](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/Z_06.asm) (dados do overworld e diretório de colunas). Os bytes gráficos e de mapa são lidos da ROM do usuário, não baixados dessas referências. ## Assets e composição `assets/tilesets/overworld` contém o banco de terreno, com 21 glyphs 8×8. `assets/scenes/overworld_start` contém a cena 32×30, com o terreno na camada 0. Link e a espada são emitidos na camada 1 para ficarem acima do cenário. A cena vazia anterior em `assets/scenes/movement` foi preservada e excluída do build. O preload confirmado é Link no glyph slot 0, terreno no glyph slot 1 e sala inicial no scene slot 0. A câmera recebe `(-112, -15)`, posicionando o cenário no mesmo retângulo 256×240 usado pelos sprites. A moldura e a máscara externas continuam sob responsabilidade de `Scene.draw_frame()`. Os PNGs do jogo não são ampliados. ## Reproduzir Na raiz, com Python 3 e Pillow: ```sh python3 tools/extract_start_room.py python3 tools/prepare_start_room.py ``` O primeiro comando apenas extrai e documenta os dados. O segundo também regenera o banco e a requisição de publicação da cena e atualiza a participação dos assets no build, preservando suas identidades. Esses arquivos são gerados; regenerar substitui eventuais edições manuais dos tiles e do mapa desta sala. O build e os diagnostics PBS passaram. Três capturas reais foram comparadas com a composição dos pixels extraídos mais os sprites já existentes. Os testes confirmaram alinhamento, ordem de desenho, ausência de rastros, movimento sem colisão de terreno e permanência da sala ao chegar à borda. Não foi feita uma comparação contra execução em um emulador NES. ## Stage e colisões `src/stages/overworld_start` possui o vínculo do cenário e os dados brutos de colisão da sala `$77`. Cada próxima tela terá sua própria stage. `src/stage` concentra o acesso à stage ativa e a sonda do jogador; `src/scene` continua responsável pela câmera, viewport e moldura. Link depende somente da API `Stage`, sem conhecer `OverworldStart` ou seus tiles. A colisão usa os IDs NES originais, preservados antes da compactação dos glyphs. A rotina `GetCollidingTileMoving` / `GetCollidableTile` em Z_07 usa o ponto `ObjY + $0B`, offsets por direção e duas amostras horizontais ao andar para cima/baixo. Escolhe o maior ID bruto antes de normalizar as nove exceções transitáveis para `$26`; IDs a partir de `$89` bloqueiam. A consulta acontece na grade de 8 pixels. Direcionais simultâneos consideram os caminhos livres, mantendo a ordem do overworld; um único direcional bloqueado ainda anima Link. As bordas externas continuam fechadas nos limites anteriores. A entrada da caverna agora dispara em `(64,77)`, com retorno à mesma abertura. Ver a documentação da stage da caverna para os percursos automáticos. As capturas desta pasta são anteriores a essa conexão. O caso especial de parede falsa da sala `$1F` não se aplica a esta stage. Não há colisão de espada com inimigos. `tools/sync_start_stage.py`, também executado por `prepare_start_room.py`, regenera `room.generated.pbs` e `collision-data.json`, conferindo o hash e as tabelas da ROM. Para reproduzir a verificação independente: ```sh python3 tools/sync_start_stage.py python3 tools/validate_collision_rom.py python3 tools/validate_stage_captures.py ``` A primeira validação executa uma porção limitada de instruções 6502 diretamente dos bytes da ROM, na entrada `$EDFA`: 2.573 sondas da grade coincidiram com o modelo do port. Exclui a sonda superior fora da área de terreno, transições e execução completa do jogo. Resultado em `collision-rom-validation.json`. A segunda compara as capturas reais obtidas pelo Studio em `collision-validation/` com o cenário extraído e os sprites nas posições do modelo: 14 casos, zero pixels diferentes. Cobre paredes, limites, canto com duas direções bloqueadas, seleção de direção livre, repouso, reversão e caverna. O script compara as capturas salvas; novas capturas exigem executar as sequências em `CASES` pelo runtime do Studio, com uma sessão nova por caso. Build/pack passaram e os sete arquivos PBS envolvidos tiveram diagnostics vazios.