24 KiB
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.pbse 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
- 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.
- 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.
- Sem retorno dos testes temporários:
ENABLE_TEMPORARY_BOMBeENABLE_BOMBABLE_SWORD_TESTestão false. Não recolocar pacote de bombas na tela inicial nem fechar a entrada da espada sem pedido explícito. - Viewport 1:1 e módulos por responsabilidade: Link em
src/link, stage por tela, apresentação emsrc/scene, inventário/vida emsrc/inventory. - 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.
- 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]. - 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. - 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
- Ler este inventário e
AGENTS.md; conferir mudanças feitas durante a pausa. - Obter controle pelo Studio quando autorizado, compilar fontes salvas e conferir diagnostics. O build histórico acima não substitui essa checagem.
- 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.
- 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.
- Ao adicionar conteúdo, extrair da ROM mapa, atributos, lista de inimigos, entradas e flags; atualizar o catálogo e reutilizar os atlas existentes.
- Regenerar caverna com
tools/prepare_cave.pyquando necessário e finalizar a recomposição compartilhada comtools/prepare_overworld.py. Consultar os documentos específicos antes de regenerar outros bancos. - Executar verificações apropriadas ao recorte; usar fixtures isoladas e restaurar main/barrels/fontes auxiliares antes do build final de produção.
- 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.