A progressão persistente deve preservar as conquistas do jogador sem transformar cada momento de uma partida de sobrevivência em estado permanente. Em um jogo de defesa de base, essa distinção importa. Um vale desbloqueado ou uma melhoria no acampamento pode fazer parte do mundo, enquanto os inimigos que atacam o portão naquele momento normalmente pertencem apenas à partida daquela noite.

Se um assistente de IA for editar um projeto existente, comece descrevendo o que já funciona e o que precisa permanecer como está. Em seguida, delimite o salvamento aos resultados permanentes. Este guia usa um protótipo fictício ambientado em um vale de pinheiros para explicar o design, sem relatar uma implementação real ou um teste de jogabilidade.
Separe o progresso do mundo do estado da partida desta noite
Antes de pedir código, anote quais dados devem ser preservados ao reiniciar o jogo. Um bom ponto de partida é classificar cada variável em três grupos. São eles o progresso permanente do mundo, as configurações da sessão e o estado temporário da partida. Defina o escopo da progressão para evitar que ela acabe incluindo, sem que isso tenha sido planejado, um sistema completo de salvamento no meio da partida.
| Estado | Exemplos possíveis | Decisão padrão de salvamento |
|---|---|---|
| Estado permanente do mundo | Regiões desbloqueadas, defesas pesquisadas, níveis permanentes do acampamento, recursos acumulados | Salvar após um ponto de controle bem definido |
| Preferências do jogador | Volume do áudio, seleção de controles, opção de acessibilidade | Salvar separadamente da progressão do mundo |
| Partida atual | Posições dos inimigos, projéteis ativos, escudo temporário, noite inacabada | Reiniciar esse estado, a menos que o jogo já permita retomar uma partida em andamento |
No exemplo fictício, concluir uma noite pode desbloquear a torre de sinalização e acumular uma recompensa. A onda de inimigos em andamento, os pontos de vida restantes de uma barricada temporária e a posição de cada criatura são redefinidos quando começa uma nova partida. Assim, o recurso tem um escopo definido: guardar a recompensa no mundo e preservar o ciclo atual de coleta de dia e defesa à noite.
Use os termos e identificadores que o jogo já adota. Se o projeto já tem um ID de região ou de melhoria, reutilize-o. O arquivo de salvamento deve registrar identificadores estáveis, evitando caminhos frágeis de nós da cena e rótulos de interface que possam mudar com a localização.
Faça um inventário do projeto antes de alterá-lo
Use uma cópia do projeto como referência para a comparação. Anote o motor de jogo e sua versão, o comportamento atual do salvamento, a cena principal, a transição do dia para a noite, o cálculo das recompensas e os arquivos responsáveis por esses sistemas. Se possível, faça uma breve gravação de tela ou tire capturas para comparar as versões. Evite apresentar uma ilustração gerada por IA como evidência de como o projeto funciona nessa versão de referência.
Peça ao assistente que primeiro inspecione o projeto e proponha um plano detalhado por arquivo. Um pedido com escopo bem definido pode ser formulado assim. Preserve o relógio do ciclo de dia e noite, a coleta, o surgimento de inimigos, os controles e o combate. Adicione persistência apenas para materiais acumulados, IDs de regiões desbloqueadas e IDs de melhorias permanentes do acampamento. Exclua do salvamento inimigos ativos e efeitos temporários. Liste todos os arquivos que serão alterados antes de editá-los. Peça um diff pequeno e uma nota explicando como reverter a alteração.
Confira se o plano corresponde ao que o projeto realmente faz antes de aceitá-lo. Se o jogo atual armazena as recompensas no fim da noite, faça a chamada de salvamento nesse ponto já estabelecido. Evite repeti-la a cada coleta de recurso. Se o recurso introduzir um novo evento de conclusão da noite, verifique se ele é disparado uma única vez durante uma transição de cena ou uma reinicialização.
Defina o escopo do salvamento e versione o formato
Encapsule os detalhes de serialização em uma interface pequena, com funções como load_world_progress() e save_world_progress(snapshot). Os sistemas de jogabilidade devem consultar um valor ou enviar o resultado de uma ação. Evite que cada sistema grave por conta própria partes de um arquivo compartilhado. Isso facilita a inspeção, os testes e a substituição do código de armazenamento sem precisar reescrever o combate.
O exemplo abaixo mostra um modelo conceitual simples. Ele ilustra o design, e o formato de arquivo de salvamento ainda não foi testado.
{
"schema_version": 1,
"world_id": "pine_valley",
"completed_nights": 3,
"banked_materials": {"wood": 42, "ore": 8},
"unlocked_regions": ["pine_valley", "old_quarry"],
"camp_upgrade_ids": ["signal_tower_t1"]
}
Identifique a versão do esquema desde o primeiro lançamento. Quando o formato mudar, a migração poderá distinguir um registro antigo de um atual. Dê preferência a IDs estáveis para os registros de regiões e melhorias. Se o nome de um item mudar na interface, ele poderá continuar com o mesmo identificador no salvamento. Valide os valores durante a leitura. Rejeite IDs desconhecidos de forma segura, ajuste os valores numéricos aos limites apenas quando as regras do jogo definirem uma faixa válida e use um perfil novo se o registro não puder ser recuperado.
Use o mecanismo de armazenamento de dados do usuário que o motor oferece para a plataforma de exportação. A documentação da versão estável do Godot recomenda user:// para dados persistentes porque os recursos empacotados do projeto podem estar disponíveis apenas para leitura, enquanto o caminho do usuário permite gravação. A documentação do Unity indica Application.persistentDataPath para dados preservados entre execuções e informa que o local exato depende da plataforma. A escolha de qualquer um desses caminhos, por si só, não oferece sincronização na nuvem, backups, criptografia nem resolução de conflitos. Trate esses recursos como requisitos à parte.

Salve em um ponto de controle consistente
Um ponto de controle confiável ocorre quando as recompensas e as mudanças no mundo já estão definidas. No exemplo, a sequência pode começar com o fim da noite e a confirmação da derrota ou da vitória. Em seguida, credite os materiais acumulados uma única vez, desbloqueie qualquer melhoria permanente conquistada e grave um único registro consistente do progresso. Depois, inicie o próximo dia de coleta. A ordem exata depende do projeto. Preserve o comportamento atual e deixe a sequência explícita.
Considere a possibilidade de uma gravação ser interrompida. Uma abordagem conservadora é gravar um novo arquivo temporário, verificar se ele pode ser lido e só então substituir o salvamento anterior, mantendo uma cópia que possa ser recuperada se a plataforma permitir. Evite prometer segurança absoluta em todos os dispositivos ou diante de qualquer falha de armazenamento. Defina como o jogo deve reagir se a pasta de salvamento estiver ausente, se a gravação falhar ou se o arquivo estiver malformado. Mostre uma mensagem clara, preserve os dados anteriores quando possível e evite conceder a mesma recompensa duas vezes sem aviso.
Sempre que possível, torne o ponto de controle idempotente. Se a cena for recarregada após o salvamento, o mesmo evento de conclusão da noite deve manter a recompensa já registrada sem concedê-la novamente. Uma opção é gravar o identificador da partida concluída ou um marcador do ponto de controle junto com o registro do progresso e só apagá-lo quando o próximo estado estiver estabelecido. Adapte essa abordagem à arquitetura do projeto para evitar criar um sistema de eventos inteiro para um único recurso.
Peça à IA uma alteração pequena e reversível
Especifique claramente o que o assistente pode alterar, quais dados devem ser preservados ou redefinidos, quando salvar, quais sistemas existentes devem ser mantidos e quais verificações você espera. Peça que ele explique qualquer suposição antes de editar. Depois, compare o diff com o plano, inspecione o código de serialização e procure gravações fora dos pontos de salvamento previstos.
Guarde a cópia antiga do projeto e um exemplo de salvamento anterior. Durante as verificações iniciais, proteja o único salvamento que você sabe que funciona para que a nova versão não o sobrescreva. Se o assistente propuser substituir o ciclo do jogo, alterar o equilíbrio dos recursos ou reescrever o combate para simplificar a persistência, reduza o escopo do pedido e solicite um patch menor.
Teste perfis novos, perfis existentes e cenários de recuperação
Iniciar o jogo com sucesso é apenas uma das verificações. Use uma matriz de testes simples e registre a versão do jogo, a plataforma, as etapas, o resultado esperado, o resultado observado e se o perfil era novo ou havia passado por migração. A tabela a seguir é um modelo de plano de testes. Ela não registra testes já executados.
| Caso | Preparação | Resultado esperado |
|---|---|---|
| Perfil novo | Remova ou renomeie o salvamento de teste | O jogo começa com o acampamento padrão documentado e sem desbloqueios de partidas anteriores |
| Noite concluída | Conquiste uma recompensa permanente e chegue ao ponto de controle | A recompensa é creditada uma única vez, e a transição do ciclo do jogo ocorre como antes |
| Perfil existente | Feche o jogo normalmente e abra-o novamente | O desbloqueio permanente é restaurado, e a onda temporária e os bônus são descartados |
| Esquema antigo | Carregue uma cópia de um salvamento da versão anterior | A migração preserva o progresso conhecido e registra a nova versão do esquema |
| Arquivo malformado ou gravação interrompida | Use uma cópia descartável e malformada ou interrompa com segurança uma gravação de teste | O comportamento de recuperação é fácil de entender e evita recompensas duplicadas |
Compare também o projeto original e a versão modificada lado a lado. Confirme que os controles de coleta, os tempos de aparecimento dos inimigos, as transições para a noite e os custos das melhorias continuam como antes, salvo quando a alteração fizer parte explícita do recurso. Repita as verificações em cada plataforma de destino, pois os caminhos que permitem gravação e o comportamento da exportação variam. Mantenha as anotações dos testes junto com o patch e só declare que um teste passou depois de executá-lo.

Perguntas frequentes
O que deve ser preservado entre sessões em um jogo de sobrevivência e defesa de base?
Salve resultados do mundo que devem ser permanentes, como regiões desbloqueadas, melhorias permanentes do acampamento e recursos acumulados. Deixe de fora do salvamento as posições atuais dos inimigos, os efeitos temporários e uma noite ainda em andamento, a menos que o jogo já permita salvar no meio da partida. Assim, o jogador entende quais recompensas foram mantidas e o que esperar da próxima sessão.
Onde um jogo feito com Godot deve armazenar o progresso do jogador?
A documentação da versão estável do Godot recomenda o caminho user:// para dados persistentes do jogador, pois os recursos do projeto podem estar disponíveis apenas para leitura quando a versão exportada está em execução, e user:// permite gravação. Consulte a documentação atual e verifique a plataforma de destino antes de definir como armazenar os dados. O caminho escolhido não define nem valida o formato do salvamento.
Como evitar que os salvamentos existentes parem de funcionar ao adicionar progressão?
Inclua uma versão do esquema, atribua IDs estáveis aos desbloqueios e às melhorias e defina como a migração deve acontecer. Guarde uma cópia do salvamento antigo, carregue-a na nova versão e confira se o progresso conhecido foi preservado antes de sobrescrever o original. Teste a migração em uma cópia descartável antes de abrir o único salvamento do jogador.
Quando o jogo deve salvar uma noite concluída?
Salve em um ponto de controle definido após a confirmação do resultado da noite e antes do início do dia seguinte. Evite gravar recompensas parciais em vários sistemas independentes. Grave um único registro consistente do progresso e mantenha uma cópia recuperável do arquivo anterior. Escolha um ponto que o jogo existente possa atingir exatamente uma vez.
Um carregamento bem-sucedido comprova que o sistema de salvamento é seguro?
Não. Teste também um perfil novo, um salvamento feito ao concluir a noite, um arquivo ausente ou malformado, um esquema antigo e uma gravação interrompida. Verifique o ciclo de dia e noite e as recompensas após cada caso na plataforma de destino. Registre cada resultado. O plano, por si só, não comprova que os testes passaram.
Limite o escopo do salvamento para facilitar a verificação
Comece com o mínimo de dados permanentes necessário para que o jogador perceba que o mundo avançou. Um registro do progresso com versão de esquema, um ponto de controle bem definido, um plano de migração e alguns casos de teste reproduzíveis são mais fáceis de revisar do que um sistema de salvamento ligado a cada evento de combate. Quando essa primeira parte estiver estável no projeto real, amplie o escopo de forma planejada.
Se quiser explorar uma ideia diferente de jogo que possa ser jogado no navegador, experimente o SEELE AI Game Maker. Essa é uma opção à parte para criar protótipos. A ferramenta não é apresentada como solução para editar ou corrigir um projeto existente.


