chore: version Zelda 1 port and engineering records
This commit is contained in:
@@ -0,0 +1,74 @@
|
||||
# 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](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](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](west-route.md).
|
||||
Reference in New Issue
Block a user