Files

3.1 KiB

Save no memcard

Implementação inicial: um perfil, preservando inventário e progresso das salas do overworld. O menu foi ampliado para Continue / Save / Retry.

Como usar

  1. No Studio/runtime, escolha um memcard em modo persistente, com escrita. A imagem padrão do projeto é .studio/memcard.pmc, fora de build/.
  2. Na abertura, Z (Start) leva a Continue / New Game. Shift (Select) muda a opção; Z confirma. Sem save válido, escolha New Game.
  3. Durante a partida, Shift abre o menu Continue / Save / Retry. Shift muda a opção e Z confirma. Continue retoma a mesma posição e vida.
  4. Escolha Save e aguarde GAME SAVED. Z volta à abertura. Ao abrir o jogo novamente com o mesmo cartão, escolha Continue.

No menu após a morte, Continue mantém seu comportamento anterior: retorno ao início com três corações. Save também está disponível ali. Z continua abrindo normalmente o inventário durante a partida; D usa o item B.

Sem armazenamento persistente, o jogo pode funcionar no modo de memória do runtime, mas mostra MEMORY ONLY / NOT SAVED TO CARD ao tentar salvar. Não confundir essa mensagem com GAME SAVED. Cartão apenas para leitura é gerido pelo host: carregar em memória pode ser permitido, mas gravar é bloqueado.

New Game reinicia a sessão sem apagar imediatamente o save existente. Somente escolher Save substitui o único perfil. Dados inválidos ou de versão não suportada são mantidos no cartão e não são aplicados ao jogo.

Progresso preservado

O slot guarda os 40 bytes de Items e os 128 bytes de flags OW já modelados. Espada, equipamentos, bombas, rupias, chaves, capacidade de vida, coletas e segredos são restaurados. As contagens de mortes já registradas nas flags seguem a ROM; o histórico de seis salas é reconstruído, sem persistência.

Carregar começa no ponto inicial com três corações preenchidos, limitado pela capacidade. O relógio temporário é limpo (Items[$15]); posição de Link, inimigos, projéteis, drops, animações e timers não são salvos.

Perfil com nome, contador de mortes, segunda quest e bancos de flags de dungeons serão acrescentados quando esses sistemas forem portados. O formato v1 já tem identificação, tamanho, versão e checksum; detalhes e evidências em FORMAT e extracted/save/validation.

Organização e regeneração

  • src/save: codec, cache validado, metadados do memcard e commit assíncrono.
  • src/screens/save: seleção do perfil e mensagens de gravação.
  • src/game: decisões de abrir menu, salvar, carregar e retomar a partida.
  • tools/prepare_save_ui.py: fonte NES e ícone de Link; usa o banco existente. Também é executado após prepare_game_screens.py para preservar o menu dinâmico. Não foram acrescentados slots de scene.

O app_id 2137977836 é a identidade persistente e não deve mudar em upgrades. A versão do projeto e a versão do payload são independentes. O host/runtime controla criação, montagem, recuperação e decisões sobre alterações pendentes; o jogo não escreve arquivos diretamente nem salva implicitamente ao sair.