Files

3.8 KiB

Composição de stages e objetos mutáveis

O port preserva os pixels, as coordenadas, o tempo e as regras de gameplay da ROM. A organização gráfica deve aproveitar o Prometeu: uma scene com terreno fixo e sprites/glyphs independentes para elementos com estado.

  • Terreno: chão, paredes permanentes e decoração que nunca muda.
  • Objetos: NPCs, itens coletáveis, fogo e efeitos desenhados pela stage.
  • Texto: glyphs separados, com conteúdo/visibilidade próprios.
  • Estado: inventário, flags do mundo e timers de gameplay; nunca a scene ativa.

A caverna inicial exemplifica o padrão em src/stages/cave_start: CaveData fornece colisão; CavePickup controla coleta e desaparecimento; CaveArt desenha os elementos sobre a scene 1. Piscar o velho não altera a chave visual da stage nem chama bind_scene. A aparência continua sendo a extraída da ROM. Os glyphs anteriores e os IDs dos assets foram preservados. Slots legados de scene 2/3 ficam reservados para manter os IDs das demais scenes; não são selecionados para representar os estados da caverna.

A stage desenha os objetos em coordenadas NES, camada 1, abaixo de Link e do HUD (camada 2). O inventário aplica o mesmo deslocamento vertical aos objetos e ao terreno congelado. Timers permanecem pausados durante o submenu. As faixas de inventário carregam somente terreno; não embutir NPCs ou itens.

Paredes bombáveis

Desenhar no terreno base a passagem revelada. Enquanto a flag indicar parede fechada, desenhar uma cobertura de glyphs opacos nos tiles mutáveis. Uma cobertura pode usar sprites opacos: transparência só é necessária onde deve aparecer o que está atrás. Não produzir uma scene inteira por parede/estado.

BombableWall mantém o estado em WorldFlags (bit $80). A mesma flag controla:

  • emissão ou remoção da cobertura;
  • substituição dos tiles de colisão;
  • disponibilidade da entrada.

A detonação muda essa flag; o próximo frame recompõe a área. O save já persiste a flag. Distância nativa da abertura continua estritamente menor que $10 nos dois eixos, distinta do raio de dano $18. A stage é responsável por aplicar os offsets corretos durante rolagens e inventário; sprites não acompanham a câmera de terreno automaticamente.

A cobertura existente em overworld_start já segue esse padrão. Os testes temporários da bomba e da parede na entrada da espada continuam desativados. Usar esse exemplo ao adicionar paredes reais nas próximas salas.

Regressão da caverna

tools/generate_cave_composition_fixture.py install instala a entrada isolada; executar os dez frames de cases.json pelo headless e capturar cada checkpoint. tools/validate_cave_composition.py compara os estados e o inventário aos compostos de referência e executa as sondas nativas. Restaurar com tools/generate_cave_composition_fixture.py restore e recompilar antes de devolver o projeto. Evidências ficam em extracted/cave/start/composition-validation; a entrada final usa Game.frame.

O segredo real da sala $67 aplica esse padrão, incluindo a cobertura durante rolagens e submenu, interior com NPC/texto/rupia separados e save das flags. Detalhes e verificações em real-secret.md.

Aplicação na loja $66

cave_shop compartilha terreno da scene 1 e emite vendedor, texto, produtos e preços como sprites. A compra muda visibilidade por visita sem rebind de scene; os preços permanecem. Todos recebem offset de inventário. Glyphs anteriores preservados, nenhum slot adicional. Ver shop.md.

Segunda loja e percurso oeste

A loja da $44 também usa a scene 1, com arte mutável própria e ShopVisit compartilhado. Nenhuma variante de scene foi criada para comprar ou piscar. O inventário passou a 16 faixas dentro do slot 15. Stage ID 16 é um ID de conteúdo e não um slot de scene. Ver west-route.md.