Files

59 lines
3.1 KiB
Markdown

# 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](../extracted/save/FORMAT.md) 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.