Uma cidade que muda ao longo de várias sessões precisa de mais do que uma captura de tela de sua paisagem urbana. Vias, distritos, serviços, necessidades da população e eventos que dependem do tempo precisam continuar coerentes após o recarregamento. Antes de pedir à IA que adicione progressão persistente, diferencie as decisões duradouras sobre a cidade dos valores que a simulação pode recalcular.

Este guia usa uma cidade ribeirinha fictícia para descrever como estruturar o salvamento. Nenhuma via, nenhum morador e nenhuma rede de serviços foram simulados. O objetivo é adicionar persistência sem substituir os sistemas que já atualizam a cidade no projeto.
Separe as decisões duradouras sobre a cidade do estado atual da simulação
Liste o que deve ser mantido após reiniciar o jogo, como distritos desbloqueados, infraestrutura instalada, decisões de zoneamento, registros de marcos ou políticas escolhidas pelo jogador. Em seguida, liste o que muda a cada passo da simulação, como a posição dos veículos, as ocorrências em andamento, as filas de serviços, a demanda temporária ou o tempo restante de uma obra. Alguns jogos salvam o estado atual da simulação, enquanto outros reconstroem boa parte dele. Siga o modelo atual sem presumir que todas as variáveis precisam ficar em um único arquivo.
| Estado | Exemplo | Decisão de salvamento |
|---|---|---|
| Traçado da cidade | Trechos de via, IDs de distritos, construções | Salvar as alterações estáveis feitas de forma deliberada |
| Progressão | Áreas desbloqueadas, marcos concluídos | Salvar as decisões da campanha |
| Rede derivada | Conectividade das vias, alcance dos serviços | Reconstruir ou salvar conforme o modelo existente |
| Estado transitório da simulação | Eventos de trânsito, alertas temporários | Salvar somente se for necessário para retomar a partida |
No exemplo fictício de Greywater, abrir um novo distrito à beira do rio é uma decisão duradoura. Já a posição de um caminhão de bombeiros que está no meio de uma rua quando o jogador sai pode ser um dado transitório. O jogo pode reconstruir a conectividade das vias a partir de IDs estáveis, se esse já for o procedimento normal. O artigo descreve uma possibilidade, sem afirmar que ela foi implementada.
Preserve IDs estáveis e sistemas que calculam dados derivados
Use identificadores estáveis para distritos, trechos de via, tipos de construção e infraestrutura. O nome de exibição de um distrito pode mudar sem alterar sua identidade no salvamento. Evite armazenar referências a nós temporários da cena se a engine recria esses objetos ao carregar a partida.
Identifique como o jogo calcula hoje a conectividade, a cobertura de água ou energia, a demanda da população e o acesso aos serviços. Salve os dados de entrada duradouros e deixe que os sistemas existentes calculem os resultados. Se o projeto armazena dados derivados de propósito para ganhar desempenho, trate-os como cache e defina como invalidá-lo quando vias ou construções mudarem.
Peça à IA que mapeie o fluxo de salvamento e carregamento antes de editar o código. Identifique qual componente controla o mapa, qual executa cada passo da simulação, como os marcos desbloqueiam distritos e quando os dados são gravados. Solicite uma lista de arquivos, uma proposta de esquema versionado e os passos para reverter as mudanças. Evite criar um novo “gerenciador de progressão” que duplique o estado dos distritos ou da economia.

Escolha um modelo de salvamento versionado
Adicione uma versão ao esquema antes de alterar a estrutura dos dados salvos. Os novos campos precisam de valores padrão seguros para cidades existentes. Se IDs de distritos ou tipos de construção forem descontinuados, defina equivalências ou informe explicitamente quais deixaram de ser aceitos, sem descartá-los em silêncio. Guarde uma cópia de um salvamento conhecido para os testes de migração.
As opções de armazenamento dependem da engine e da plataforma de destino. O tutorial de salvamento da versão estável do Godot demonstra a serialização em arquivos e aborda as limitações do JSON. No Unity, Application.persistentDataPath é destinado a dados que precisam ser mantidos entre execuções, e sua localização varia conforme a plataforma. Essas fontes orientam as decisões de armazenamento. A economia da cidade, o esquema de dados e o processo seguro de migração precisam ser definidos para o seu projeto.
Planeje como lidar com interrupções na gravação. Preserve o salvamento anterior quando for viável, valide o novo registro antes de substituir o anterior e decida o que o jogo deve exibir se não conseguir ler os dados. Documente o comportamento que você realmente consegue verificar, sem prometer recuperação perfeita em todas as plataformas.
Registre um ponto de controle que permita reproduzir o estado da cidade
Ao gravar um salvamento, registre contexto suficiente para reproduzir o estado da cidade, incluindo a versão do esquema, o ID do mapa ou cenário, os IDs dos distritos desbloqueados, a infraestrutura escolhida pelo jogador, os fundos e o último passo da simulação confirmado. Evite incluir valores transitórios apenas porque aparecem na interface. O projeto deve definir se o trânsito, as ocorrências e as filas de serviços serão retomados ou recalculados.
Um ponto de controle também ajuda a diagnosticar divergências. Se o mapa for recarregado e a cobertura de água mudar, compare primeiro os dados estáveis das vias e construções. Depois, examine o cálculo que a rede já usa. Mantenha uma cidade de referência para testar cada correção com as mesmas vias e instalações de serviços.
Mantenha a progressão da cidade separada dos passos da simulação
O desbloqueio de distritos e as decisões de construção podem ser confirmados em marcos bem definidos. A simulação ainda precisa respeitar a ordem atual de cada passo. Por exemplo, atualizar a demanda, avaliar os serviços, aplicar a manutenção, resolver as ocorrências, atualizar os fundos e, por fim, atualizar o mapa. Siga a ordem que o projeto já define. A persistência deve impedir que o mesmo dia ou mês seja avançado duas vezes quando o jogador voltar à cidade.
Garanta que repetir o salvamento seja seguro. Se o mesmo callback de um marco for executado duas vezes, ele deve conceder os fundos e a recompensa pelo desbloqueio do distrito uma única vez. Use IDs estáveis para os eventos se o código já oferecer esse suporte e deixe um único componente responsável pelas alterações de saldo.
Revise o diff em busca de alterações fora do escopo nos custos das vias, nos raios de cobertura dos serviços, no crescimento populacional, nas regras de zoneamento e no relógio da simulação. Compare a mesma cidade antes e depois da alteração. Um novo painel de salvamento pode ser exibido corretamente mesmo que os cálculos da rede tenham mudado.

Verifique uma cidade nova, o recarregamento e salvamentos antigos
As verificações a seguir são propostas para teste. Greywater não foi submetida a esses testes.
| Caso | Ação | O que verificar |
|---|---|---|
| Cidade nova | Criar um novo perfil | Os distritos e serviços são carregados no estado padrão |
| Alteração no traçado | Construir vias e desbloquear um distrito | Os IDs estáveis e a progressão são salvos |
| Rede de serviços | Alterar uma conexão entre vias | A lógica existente recalcula corretamente a cobertura |
| Avanço da simulação | Avançar um período no jogo | Os fundos, as necessidades e os eventos são atualizados uma única vez |
| Recarregamento | Salvar, sair e reabrir o jogo | O traçado da cidade e os serviços calculados a partir dele são coerentes entre si |
| Salvamento antigo | Carregar uma cópia de uma cidade salva antes da implementação do recurso | A migração preserva as construções e os fundos conhecidos |
Registre as versões da engine e do projeto, o salvamento de referência, as alterações no mapa, o estado do passo da simulação, as etapas do teste e os resultados esperados e observados. Compare o mesmo distrito antes e depois do carregamento. Um mapa gerado ou uma sobreposição simulada pode ilustrar o conceito. Para confirmar que a rede viária ou a economia funciona corretamente, é preciso verificá-la no jogo.
Perguntas frequentes
Que progresso da construção da cidade deve ser mantido entre sessões?
Salve decisões tomadas sobre a cidade, como distritos desbloqueados, marcos concluídos e infraestrutura aprovada. Mantenha separados os dados do passo atual da simulação, os atrasos temporários nos serviços e os eventos pendentes, a menos que o jogo já permita retomar exatamente esse estado. Especifique quais marcos e registros da cidade fazem parte do salvamento.
Como manter as vias e os serviços coerentes após o carregamento?
Salve IDs estáveis de vias e distritos e reconstrua a conectividade a partir deles pelo fluxo de simulação que o projeto já usa. Evite manter manualmente uma segunda cópia dos dados sobre o alcance dos serviços, pois ela pode divergir do mapa carregado. Reconstrua a rede somente pelo sistema que o jogo já usa para esse cálculo.
As necessidades da população devem ser salvas ou recalculadas?
Siga o modelo de estado atual do jogo. Salve o estado duradouro dos domicílios e distritos. Se o projeto já funciona assim, recalcule a demanda derivada no passo normal da simulação. Mantenha os registros duradouros dos domicílios separados dos valores de demanda derivados. Vincule os cálculos derivados ao passo da simulação selecionado.
Como migrar salvamentos antigos da cidade com segurança?
Adicione uma versão ao esquema e defina valores padrão para os novos campos. Teste a migração em uma cópia de uma cidade antiga e compare as vias, as construções, a cobertura dos serviços, a população e os fundos antes de substituir um salvamento em uso. Compare todos os totais essenciais da cidade antes de substituir um salvamento antigo.
O que devo testar depois de adicionar progressão persistente à cidade?
Teste uma cidade nova, o salvamento do desbloqueio de um distrito, alterações nas vias, a cobertura dos serviços, o avanço do tempo, o recarregamento e um salvamento antigo. Registre os resultados obtidos na build. Um mapa fictício não constitui um teste da simulação. Inclua a versão do mapa, o ID do distrito e o passo da simulação nas anotações do teste.
Comece com um marco da cidade
Primeiro, salve o desbloqueio de um distrito e uma alteração no traçado. Mantenha os IDs estáveis e use a simulação atual da cidade para reconstruir os dados derivados dos serviços. Depois, verifique uma cidade nova, o recarregamento de uma cidade salva e um perfil antigo antes de incluir mais dados de progressão.
Se você tem uma ideia para um protótipo independente que possa ser jogado no navegador, experimente o SEELE AI Game Maker. O convite é para criar um protótipo separado, sem envolver o reparo de um salvamento existente.


