Files
zelda-1-prometeu-port/docs/port-status.md
T

24 KiB
Raw Blame History

Inventário do port e ponto de retomada

Pausado por pedido do usuário em 09/11/2026, após concluir o percurso oeste até a loja de bombas da $44.

Este documento registra o estado do port de Zelda 1 NES para Prometeu. O inventário original da pausa foi feito nos fontes e relatórios salvos. Na retomada, o Zora foi implementado e validado em novos builds e sessões headless; as evidências desse recorte estão em extracted/zora.

O recorte atual permite iniciar uma partida sem espada, entrar na caverna, coletar a espada, explorar 13 telas do overworld e quatro cavernas, comprar nas lojas da $66 e $44, enfrentar Octoroks/Zora, obter drops, usar bombas, abrir o inventário, morrer/continuar e salvar/carregar um perfil no memcard. Ainda não permite completar o jogo.

Ponto de pausa atual — 09/11/2026

O usuário pediu para parar por enquanto. Não há implementação em andamento. Última entrega: percurso oeste e loja da $44, descritos em west-route.md. Estado jogável: 13 telas do overworld e quatro interiores, duas lojas, combate com Octoroks/Zora, bombas, inventário e save/load. A lista aceita de quatro recortes foi concluída.

  • Último build/pack aprovado: 9a71c3be-7b87-4533-bfc0-cbfd36e30108.
  • Fixtures removidas; src/main.pbs e Game restaurados. Studio em modo manual, sem sessão headless mantida pelo agente. Cartão do usuário preservado.
  • Smoke final: New Game, coleta/pose da espada, Continue com cartão descartável em leitura somente, quitação de débito, bomba 8→7 e inventário aberto/fechado.
  • Build e testes runtime passaram. LSP teve falhas intermitentes em três fontes; não registrar essas consultas como diagnostics vazios. Evidência e demais atritos em prometeu-feedback.md.
  • Próximo recorte sugerido, ainda não iniciado nem escolhido pelo usuário: uso da vela e um segredo queimável real, conferindo primeiro as regras e o local na ROM. Depois, considerar percurso rumo à primeira dungeon.
  • Vela azul já pode ser comprada, mas não produz fogo. Flechas já podem ser compradas, mas o uso de arco/flechas está pendente. Dungeons ainda pendentes.

Ao retomar, ler este bloco, AGENTS.md e os documentos do recorte; conferir mudanças locais e obter o controle do Studio antes de editar/testar pelo agente. Não reutilizar taskId da sessão encerrada nem reativar bombas de teste no início.

Como interpretar o inventário

  • Portado no recorte: implementado para as telas e os atores existentes; não significa que todo o sistema original esteja coberto.
  • Parcial: existe estrutura ou comportamento, mas falta conteúdo, integração ou parte das regras para representar o sistema completo.
  • Pendente: não há implementação jogável identificada no estado atual.
  • Assets extraídos, tabelas e ícones disponíveis não equivalem a gameplay portado.

O que já foi portado

Área Estado e comportamento disponível Fontes principais
Assets NES Extração de patterns, paletas, mapas e descritores utilizados no recorte; PNGs e dados rastreáveis à ROM local verificada. Não é certificação de extração de todo o conteúdo do jogo. tools/extract_graphics.py, tools/extract_start_room.py, tools/nes_object_graphics.py, assets/, extracted/
Apresentação Área NES de 256×240, escala 1:1, centralizada numa caixa; terreno, atores e HUD compostos separadamente. HUD na camada 2, atores na 1. src/scene, src/hud
Link: movimento Quatro direções, animação, alinhamento à grade e movimento fracionário orientados pela ROM; escolha de direção conforme posição na grade, não uma prioridade vertical global inventada. src/link/movement.pbs, src/link/controller.pbs
Link: espada Ataque direcional, animação e alcance; começa sem espada; coleta da primeira espada com pose de erguer o item. Graus de espada tratados nos dados/dano, sem todos os locais de aquisição. src/link/sword.pbs, src/link/render.pbs, src/inventory
Projétil de espada Disparo condicionado à vida cheia, slot único e dispersão; colisão com os inimigos existentes. src/link/beam.pbs
Defesa e dano Bloqueio frontal das pedras com escudo, ricochete, contato com inimigos/fogo, imunidade temporária e recuo. src/enemies/octorok/rock.pbs, src/link/vitals.pbs
Vida Corações e fração nativa, capacidade, dano, cura, itens de vida e continuação com três corações; efeitos dos graus de anel nos cálculos/paleta. Aquisição de todos esses equipamentos pelo mapa ainda pendente. src/inventory/life.pbs, src/link/vitals.pbs
Bombas Seleção no slot B, consumo, colocação, fusível, explosão e efeitos, limites de slots e dano aos inimigos existentes. Não acrescentar dano ao próprio Link por suposição. src/link/bomb.pbs, src/link/main.pbs
Paredes bombáveis Mecanismo reutilizável: detonação, limiar nativo, flag persistente, cobertura visual, colisão e entrada coordenadas. Integrado ao segredo real da $67; outros locais continuam pendentes. src/world/bombable_wall.pbs, src/stages/overworld_start
Stages e colisões Uma stage por tela, dados nativos e sondas compartilhadas de jogador/monstros. Transições horizontais/verticais e entrada/saída da caverna. src/stages, src/stage
Zora Ator $11, bola de fogo $55, surgimento em água, estados nativos, vulnerabilidade, morte/drop e regra do escudo mágico; integrado à $65. src/enemies/zora, zora.md
Octoroks Tipos $07/$08/$09: vermelho lento, vermelho rápido e azul lento; animações, movimento, pedras, HP, reação a golpes, morte e drops. Pool de cinco atores atende às salas atuais. src/enemies/octorok
Nascimento de inimigos Nuvens nas salas correspondentes e entrada pelas bordas nas quatro salas novas; cursor, timer, distância de segurança e ordem de slots orientados pela ROM. src/enemies/octorok/edge.pbs, src/overworld
Persistência entre visitas Flags nativas do overworld, contagem de mortes registrada na saída e histórico de seis salas; respawn depende dessas regras, não é simplesmente proibido ao trocar de tela. src/world
Drops Tabelas/grupos nativos, contadores de ajuda, bombas, rupias, corações e fada; tempo de vida, coleta por contato/espada e voo da fada. src/loot, src/combat_graphics
Inventário: dados Bloco Items de 40 slots, classes/graus, contadores, fila de rupias e seleção B separada; flags de coletas não se confundem com posse. src/inventory, src/world
Inventário: tela Abre/fecha com rolagem, pausa gameplay, mostra conteúdo e seleciona item B; HUD e fundo acompanham a sala ativa. src/screens/inventory
Caverna da espada Entrada/saída, primeira aquisição, texto, velho, fogo e desaparecimento após a coleta. Objetos e letras agora são sprites sobre terreno fixo, inclusive durante a rolagem do inventário. src/stages/cave_start
Abertura e fluxo Tela de título com brilho/cachoeira, New Game/Continue, abertura da área de jogo, morte, Game Over, Continue/Save/Retry e retorno ao título. src/game, src/screens/title, src/screens/continue_menu
Save/load Um perfil no memcard, commit assíncrono, validação de payload, mensagens de erro/modo memória, restauração de Items e flags OW. Validado também manualmente pelo usuário. src/save, src/screens/save, save.md

Conteúdo de mapa disponível

São 13 telas do overworld e quatro cavernas jogáveis. Os IDs internos não são os IDs nativos: preservar o mapeamento do catálogo.

Stage Sala NES Módulo em src/stages Observação
0 $77 overworld_start Tela inicial; entrada da espada aberta; testes temporários desativados.
1 Caverna ligada a $77 cave_start Espada coletável, velho/texto/fogo; terreno único com objetos separados.
2 $67 overworld_north Octoroks e parede bombável que leva ao prêmio de 30 rupias.
3 $66 overworld_northwest Rota oeste e entrada aberta da loja.
4 $65 overworld_northwest_2 Octoroks e Zora da flag nativa.
5 $64 overworld_bomb_field Rota de obtenção de bombas por drops; não há garantia por morte.
6 $57 overworld_north_upper Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes.
7 $58 overworld_northeast_upper Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes.
8 $68 overworld_east Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes.
9 $78 overworld_start_east Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes.
10 Caverna ligada a $67 cave_secret Moblin $7B, prêmio único de 30 rupias; retorno à sala norte.
11 Caverna ligada a $66 cave_shop Loja $78: escudo mágico, chave e vela azul.
12 $56 overworld_west_1 Octoroks e Zora; segredo secundário pendente.
13 $55 overworld_west_2 Um Octorok e Zora.
14 $54 overworld_west_3 Octoroks, Zora e ligação ao campo de bombas.
15 $44 overworld_shop_west Octoroks e entrada aberta da loja.
16 Caverna ligada a $44 cave_supply_shop Loja $77: escudo mágico, quatro bombas e flechas.

Conexões implementadas, todas reversíveis:

$44
 │
$54 ── $55 ── $56 ── $57 ── $58
 │      │                    │
$64 ── $65 ── $66 ── $67 ── $68
                      │      │
                     $77 ── $78
                      │
                caverna da espada

No diagrama, a ligação caverna/$77 representa entrada/saída, não adjacência geográfica ao sul. Não há conexão direta $67→$57: a borda é sólida. As 15 conexões de overworld correspondem a 30 transições direcionadas. Catálogo: tools/overworld_manifest.json; detalhes em overworld.md.

O que está parcial ou ainda falta

Área Pendência
Overworld completo Restante das 128 posições de tela do mapa, conectividade, atributos, encontros e conteúdo específico; não abrir bordas sem portar o destino.
Zora Primeiro encontro da $65 implementado; ampliar regressões ao adicionar salas, armas e interações futuras. Ver zora.md.
Outros inimigos Demais famílias do overworld e dungeons, com descritores, comportamento, dano, drops e regras de spawn próprios.
Cavernas e NPCs Outras cavernas/lojas além das quatro atuais; demais pagamentos, jogos e diálogos específicos. Entradas/segredos secundários das salas de expansão ainda estão pendentes.
Texto e abertura Revelação progressiva de diálogos e lógica de texto mais completa; história/demo automáticas do título ainda pendentes. A mensagem da espada aparece inteira.
Segredos reais Primeira parede/caverna da $67 integrada; ampliar aos outros locais da ROM; implementar árvores queimáveis, pedras/blocos movíveis e demais gatilhos nativos. Os demais locais e tipos de segredo ainda não estão integrados.
Uso dos itens B Bombas funcionam; há caminho de consumo/cura de poção no código, sem aquisição normal integrada neste recorte. Bumerangue, arco/flechas, vela, apito, comida, vara e demais usos ainda precisam de gameplay. Seleção/ícones/dados não bastam.
Equipamentos e travessia Locais e requisitos de espadas superiores, anéis, escudos/upgrades, escada, jangada e demais equipamentos; completar seus efeitos específicos e acesso ao mapa.
Progressão Aquisições e economia além do circuito atual, recipientes de coração no mapa, progressão de chaves, itens únicos e requisitos de acesso.
Dungeons Entradas, salas, portas/chaves, bloqueios, empurrar blocos, escadas/passagens, mapas/bússolas, itens e persistência de estado própria. Nenhuma dungeon jogável identificada.
Chefes e Triforce Chefes, fragmentos, progressão de dungeons, Ganon, resgate e encerramento.
Perfis e segunda quest Nome/seleção de três perfis, contador de mortes, segunda quest e suas diferenças de conteúdo. Save atual tem um perfil.
Save futuro Evoluir o schema quando existirem flags de dungeons, novos metadados e segunda quest; prever migração. Não mudar app_id para isso.
Áudio Música e efeitos ainda fora da primeira wave, conforme escopo combinado.
Fidelidade integral Expandir regressões por sistema/sala. Os oráculos atuais executam rotinas 6502 delimitadas; não existe validação lockstep do jogo inteiro.

Limites e decisões a preservar

  1. Fidelidade de comportamento e imagem à ROM, com organização adequada ao Prometeu. Não é necessário reproduzir a organização gráfica interna do NES.
  2. Terreno fixo + elementos mutáveis separados. NPCs, texto, itens e coberturas de paredes bombáveis devem ser sprites/glyphs independentes. Render, colisão e entrada de um segredo usam a mesma flag persistente. Referência: scene-composition.md.
  3. Sem retorno dos testes temporários: ENABLE_TEMPORARY_BOMB e ENABLE_BOMBABLE_SWORD_TEST estão false. Não recolocar pacote de bombas na tela inicial nem fechar a entrada da espada sem pedido explícito.
  4. Viewport 1:1 e módulos por responsabilidade: Link em src/link, stage por tela, apresentação em src/scene, inventário/vida em src/inventory.
  5. Limite atual de 16 slots de scene: slots 2/3 da caverna estão reservados para compatibilidade de IDs; gameplay usa scene 1 fixa. Atlas de salas, transições e inventário ficam em 13/14/15. Não adicionar slot 16 sem rever a organização/capacidade. O inventário mantém 16 faixas de composição.
  6. Save v1: 180 bytes, header 12 + Items 40 + flags OW 128; app_id=2137977836, um slot/perfil. Histórico de visitas, posição, inimigos, projéteis, drops e timers não são salvos. Carregar retorna ao início com três corações e capacidade preservada; limpa Items[$15].
  7. Proteger o cartão do usuário: .studio/memcard.pmc; testes em imagens separadas ou memória. New Game não apaga imediatamente o save; Save explícito substitui o único perfil. Não tratar MEMORY ONLY como GAME SAVED.
  8. Fontes e documentação PBS: consultar referências do Studio antes de recorrer a Java. Manter prometeu-feedback.md com evidência concreta; escolhas do port não devem virar defeitos do runtime.

Validação já registrada

Recorte Evidência preservada
Expansão do overworld 16.524 sondas de colisão nativas, 192 buscas de entrada pelas bordas, 18 transições direcionadas e 45 comparações visuais exatas. Relatórios em extracted/overworld/expansion/.
Caverna com objetos separados Dez comparações visuais exatas, 2.573 sondas nativas; coleta, flag, posse, piscadas, timer, pausa e revisita. extracted/cave/start/composition-validation/.
Save Payloads, checksum, reopen, leitura somente, modo memória, dados inválidos e fluxo de UI; evidências em extracted/save/, com detalhes em save.md. Teste manual aprovado pelo usuário.
Demais sistemas Fixtures e validadores de Link, vida, inventário, combate, drops, bombas, paredes, gráficos, HUD e fluxo em tools/; relatórios/capturas em extracted/. Não assumir que todos os scripts antigos foram reexecutados após cada mudança.

Build de produção anterior à retomada: 5e713d48-8d9c-480d-9d35-a9aa112751a8, após a refatoração da caverna. Diagnostics vazios nas cinco fontes consultadas naquela entrega. Teste por input normal: New Game → caverna → coleta/pose da espada → desaparecimento do velho → inventário.

A entrada atual src/main.pbs chama Game.boot/Game.frame e MemcardBoot; não contém a fixture. O Studio foi devolvido ao modo manual na última entrega. Na pausa não houve alteração de gameplay; na retomada foi acrescentado o Zora.

Retomada sugerida

  1. Ler este inventário e AGENTS.md; conferir mudanças feitas durante a pausa.
  2. Obter controle pelo Studio quando autorizado, compilar fontes salvas e conferir diagnostics. O build histórico acima não substitui essa checagem.
  3. Ao retomar um novo recorte, fazer um smoke com cartão de teste: iniciar sem espada, coletar na caverna, abrir/fechar inventário, sair, combater um Octorok, salvar e carregar.
  4. Lista aceita na retomada: Zora da $65 → segredo bombável real → loja → expansão de um percurso com objetivo. O Zora é o primeiro recorte; os seguintes são concluídos por recorte, com evidências abaixo.
  5. Ao adicionar conteúdo, extrair da ROM mapa, atributos, lista de inimigos, entradas e flags; atualizar o catálogo e reutilizar os atlas existentes.
  6. Regenerar caverna com tools/prepare_cave.py quando necessário e finalizar a recomposição compartilhada com tools/prepare_overworld.py. Consultar os documentos específicos antes de regenerar outros bancos.
  7. Executar verificações apropriadas ao recorte; usar fixtures isoladas e restaurar main/barrels/fontes auxiliares antes do build final de produção.
  8. Atualizar este inventário e o feedback com o que mudou e os limites restantes.

A pausa anterior foi encerrada pelo usuário e a lista aceita foi executada. O ponto de pausa atual está no início deste documento.

Retomada: primeiro recorte concluído — Zora

A lacuna da $65 foi fechada: ciclo e disparo, arte, vulnerabilidade, dano/morte/drop, bloqueio por escudo mágico e reinício por visita. Duas sequências foram comparadas no guest com 388 ticks de UpdateZora da ROM; o cálculo angular teve 1.369 pares conferidos. Sete comparações de assets e doze de composição runtime foram exatas. Asserts de integração cobrem água, lotação, submersão, bomba, morte sem reaparição na visita, nova visita, relógio e escudos.

O encontro com Octoroks, abertura/fechamento do inventário e saída para a sala vizinha foi exercitado com Game.frame e uma entrada de teste isolada. As nove salas mantiveram as 16.524 sondas nativas de colisão aprovadas. A entrada de produção foi restaurada. Não foram reativados os testes temporários de bombas, adicionados slots de scene ou alterados app_id/schema do save.

Lista restante: segredo bombável real → loja → expansão de percurso com objetivo.

Build final do recorte Zora: dee2921c-11fd-4b45-9287-f24a3f87e9f0. Compilação/pack aprovados e diagnostics vazios nas seis fontes centrais consultadas. Boot e New Game revalidados sem fixtures, em memory_fresh.

Segundo recorte concluído — segredo bombável real

Sala $67: parede nativa em (112,80), entrada (112,77), caverna Moblin $7B com prêmio único de 30 rupias. Stage própria cave_secret (10); terrain scene compartilhada com objetos mutáveis separados. Abertura, colisão, entrada, retorno, crédito e persistência implementados. Sem bomba de teste no início.

Ver real-secret.md. Foram conferidos 121 contatos nativos, 4.352 pixels de suporte da máscara de porta, oito recortes visuais exatos, o ciclo de bomba/consumo/entrada/saída/revisita e gravação/reabertura de um cartão descartável. Payload v1 contém flags $91 na sala $67, 30 rupias e 3 bombas, com checksum válido. O cartão do usuário não foi alterado.

Regressão no build normal: caverna da espada com coleta e saída; Continue de save de teste e caminhada da tela inicial até a caverna secreta já coletada. Build final do recorte: dc681b23-7485-4a72-bcfc-7a29f3ac376b.

Lista restante: loja → expansão de percurso com objetivo.

Regressão adicional do segundo recorte: 18 transições do overworld, 45 comparações visuais e seis capturas intermediárias da cobertura da parede reexecutadas e aprovadas, além das 16.524 sondas e 192 buscas de borda.

Build/pack final aprovados; diagnostics vazios nas sete fontes consultadas. Entrada de produção restaurada; nenhum helper de fixture ficou em src.

Terceiro recorte concluído — loja da $66

Stage 11 cave_shop, tipo nativo $78: escudo mágico por 160, chave por 100 e vela azul por 60 rupias. Entrada aberta (112,77), compra por contato, pose de aquisição de 128 ticks e saída para a própria $66. Uma compra por visita; estoque reposto na próxima entrada, inclusive após load, apesar do bit de item coletado persistente. Débito passa por Items[$27], sem alterar schema/app_id do memcard. Ver shop.md.

Nove salas OW e três interiores: espada (1), segredo (10), loja (11). A loja compartilha a scene de terreno 1; vendedor, texto, preços e produtos são sprites. Nenhum slot de scene adicionado. Preços continuam visíveis após comprar; os demais objetos seguem o desaparecimento nativo por visita.

Validação: 150 casos de aquisição/débito com rotinas da ROM, 13 comparações exatas de composição/poses e asserts de entrada, saldo insuficiente, compra única, saída, revisita e menu. Save durável em cartão descartável reaberto: Items preservados e débito pendente de 60 liquidado após load. Cartão do usuário não alterado. As 16.524 sondas de colisão e 192 casos de borda passaram.

Limites: compra/posse/seleção da vela implementadas; fogo da vela e árvores queimáveis pendentes. Chaves acumulam, mas portas de dungeon ainda pendentes. Texto aparece inteiro, como nas cavernas anteriores. Demais lojas pendentes.

Próximo recorte da lista aceita: expansão de um percurso com objetivo.

Integração adicional via Game.frame com inicialização isolada na entrada da $66 confirmou a loja e abertura do submenu. O smoke de produção confirmou New Game, coleta da espada, saída e transição até a $66; o trajeto longo terminou em morte antes da loja. Ver limites e evidência em docs/shop.md. Todas as entradas/helpers temporários foram restaurados antes do build final.

Build/pack final da loja: ee40b41e-bd92-4648-bd2b-386e62c9bc00. Diagnostics vazios nas oito fontes consultadas; build final sem diagnósticos. Boot/New Game revalidados após restauração, em memory_fresh.

Quarto recorte concluído — percurso oeste com loja de bombas

Quatro salas ($56/$55/$54/$44), seis novas ligações reversíveis e interior próprio da loja $77. O percurso $58→$57→$56→$55→$54→$44 tem aquisição concreta: quatro bombas por 20 rupias; a loja também vende escudo por 130 e flechas por 80. Atalhos nativos ligam $55↔$65 e $54↔$64. Ver west-route.md.

Agora são 13 salas OW e quatro interiores, sem novos slots de scene. Zora nas três salas novas que possuem a flag; encontros preservam listas e quantidades. Compra/visita compartilhada em src/shop; arte, dados e render por stage. Inventário recomposto em 16 faixas. IDs antigos do HUD/caverna preservados.

Validação: 23.868 sondas e 384 buscas nativas, 30 transições, 116 checkpoints verdes, 69 comparações visuais do overworld e 12 da loja. Foram executados 400 casos nativos da loja nova e 150 da anterior, com Game.frame para entrada, menu, compra, saída e reposição. Save durável e reabertura confirmaram oito bombas, flechas, escudo e quitação do débito pendente. Cartão do usuário intacto. Os limites de infraestrutura e da fixture estão descritos no documento do recorte.

A lista aceita na retomada foi concluída por estes quatro recortes. Próximas opções úteis: uso da vela e um segredo queimável real; depois ampliar um trajeto rumo à primeira dungeon com as famílias de inimigos correspondentes. Flechas já podem ser compradas, mas o uso de arco/flechas continua pendente.

Build/pack final: 9a71c3be-7b87-4533-bfc0-cbfd36e30108, sem diagnósticos. Fixtures removidas; main e máquina Game restaurados. Smoke normal: New Game, coleta/pose da espada e Continue pelo menu com cartão descartável em leitura somente; quitação do débito, uso de bomba (8→7) e inventário aberto/fechado. Diagnostics vazios em ShopVisit, StageFlow e Stage; três outras consultas de fontes retornaram INFRASTRUCTURE_FAILURE do LSP, registradas no feedback. O build e as verificações runtime passaram; não contar falha de LSP como vazio.