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
- No Studio/runtime, escolha um memcard em modo persistente, com escrita.
A imagem padrão do projeto é
.studio/memcard.pmc, fora debuild/. - Na abertura, Z (Start) leva a Continue / New Game. Shift (Select) muda a opção; Z confirma. Sem save válido, escolha New Game.
- 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.
- 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ósprepare_game_screens.pypara 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.