Salve o progresso dos enigmas sem simplificar as ramificações da história

Use IA para salvar o progresso dos enigmas em um jogo de narrativa ramificada existente. Preserve as escolhas, as consequências persistentes e os finais, e compare as builds.

Seele Editorial TeamAtualizado 16 de novembro de 2026

Quando o jogador volta, o jogo deve se lembrar de que ele resolveu um enigma que mudou a história. Para isso, basta salvar o que importa, sem registrar cada tecla pressionada. Em um jogo de narrativa ramificada, a conclusão persistente de um enigma, uma tentativa temporária e a consequência na história são três estados distintos. Separá-los ajuda a encaixar uma alteração feita com IA na lógica de diálogos e finais que já existe.

Em um escritório fictício de farol, um livro de pistas aberto se conecta a dois caminhos da história. Um código temporário, digitado pela metade, fica à parte.
Arte conceitual de um farol fictício que ilustra a separação entre os estados. A imagem não é uma captura de tela do jogo.

O livro de pistas do farol, apresentado a seguir, é um exemplo didático fictício. Ele não descreve um projeto, um teste ou um estudo com jogadores de verdade. Use o exemplo para planejar a alteração e, antes de fazer qualquer afirmação sobre a implementação, verifique o comportamento no projeto real.

Separe o estado de conclusão, o estado da tentativa e a consequência na história

Comece listando o que o jogo já registra. Um enigma pode ter um ID definido no conteúdo do jogo, um estado de conclusão, uma recompensa, um nível de dica, uma entrada parcial e um ou mais indicadores narrativos. Identifique quais valores sobrevivem a uma troca de cena, quais são mantidos após reiniciar o jogo e quais são temporários por definição. O fato de todos esses dados aparecerem na mesma tela não é motivo para salvá-los em um único objeto.

EstadoExemploO que decidir
Definição do enigmaOrdem das pistas, regra de solução, momento da história associadoFaz parte do conteúdo do jogo e é versionada com o projeto
ConclusãoID estável do enigma do livro de pistas resolvidoSalve se a conclusão precisar ser mantida quando o jogador voltar
TentativaCódigo parcial, seleção atual, dica ativaDefina se a tentativa será reiniciada ou retomada
ConsequênciaIndicador de diálogo, rota liberada, pré-requisito para um finalUse o componente que já controla o estado narrativo

No exemplo, resolver o enigma do livro de pistas pela primeira vez registra o ID do enigma e ativa o indicador narrativo já existente de que a pista foi encontrada. Se o personagem sai do escritório, a pista continua registrada. Um código digitado pela metade no teclado numérico é apagado ao sair. Ao reabrir o enigma, é possível ver sua apresentação novamente, mas o jogo não concede a pista outra vez. Essa decisão evita recompensas duplicadas e condições inconsistentes nas ramificações da história.

Mapeie o fluxo da história antes de pedir alterações à IA

Acompanhe um enigma existente desde o acionamento da interação até o próximo diálogo ou ramificação. Identifique o script ou registro de dados que determina a conclusão do enigma, onde o jogo armazena os indicadores narrativos, como as cenas são recarregadas e como a lógica dos finais consulta esses indicadores. Faça uma cópia do projeto e de um arquivo de salvamento de exemplo antes de alterar qualquer coisa.

Peça à IA que mapeie esse fluxo e proponha a menor alteração possível. Especifique o que deve ser preservado no jogo, incluindo a ordem dos diálogos, a disponibilidade das escolhas, os finais atuais, os controles dos enigmas e o comportamento das dicas. Peça à IA que reutilize o indicador narrativo ou o mecanismo de eventos existente e informe quais arquivos pretende modificar. Só aceite um segundo sistema de “progresso dos enigmas” depois de entender como ele se mantém consistente com o estado narrativo que já existe no projeto.

Use identificadores estáveis para que o salvamento funcione mesmo quando o texto exibido mudar. “ledger_solution” pode continuar sendo a chave de salvamento mesmo que o título do enigma mude em uma edição ou tradução futura. Um ID estável também permite que o sistema narrativo consulte a conclusão sem precisar buscar o título traduzido.

Conecte o enigma à história com um único evento de conclusão

Use um único ponto de ligação entre a interação e a atualização narrativa. Ao receber uma solução válida, o enigma pode emitir seu ID estável e a consequência prevista. O componente que controla o estado narrativo verifica se esse ID já está marcado como concluído, concede a pista ou recompensa uma única vez e atualiza o indicador da ramificação existente. Esse fluxo é mais fácil de inspecionar do que ter o teclado numérico, a tela de diálogo, o diário e a lógica do final gravando, cada um, uma cópia do mesmo fato.

Um registro conceitual poderia ter esta estrutura.

{
  "schema_version": 1,
  "solved_puzzle_ids": ["lighthouse_ledger"],
  "story_flags": {
    "keeper_clue_found": true,
    "north_stairs_open": false
  }
}

Esse esquema ainda não foi testado. Se o projeto já distingue os dados de conteúdo do estado em tempo de execução, mantenha a definição do conteúdo separada do progresso do jogador. Defina como lidar com IDs de enigmas ausentes ou descontinuados para que renomear um enigma não apague silenciosamente todas as escolhas da história que dependem dele.

A resolução de um enigma do farol gera uma única consequência para duas ramificações narrativas existentes, enquanto uma tentativa temporária desaparece.
No fluxo conceitual do evento, a conclusão do enigma atualiza o estado narrativo que o jogo já controla.

Escolha como armazenar os dados com base no caminho de dados aceito pela engine e na arquitetura existente do projeto. A documentação da versão estável da Godot recomenda user:// para dados persistentes do usuário e demonstra como fazer um salvamento simples em JSON, apontando as limitações de tipos de dados e codificação. A Unity documenta Application.persistentDataPath para dados mantidos entre execuções, com um local que varia de acordo com a plataforma. A modelagem da história ramificada é uma decisão de cada projeto que essas páginas de documentação deixam em aberto.

Defina em linguagem simples o que acontece ao revisitar ou reiniciar um enigma

“Jogar o enigma de novo” pode significar várias coisas. O jogador pode voltar à sala, ver a animação da pista, resolver o enigma novamente, redefinir o indicador narrativo ou receber a recompensa outra vez. Defina qual desses comportamentos o jogo deve permitir. Uma opção segura para enigmas narrativos é permitir que o jogador repita a interação sem repetir uma consequência única, a menos que o jogo ofereça explicitamente desfechos alternativos.

Defina também o que será reiniciado. Recomeçar um capítulo pode apagar as pistas específicas daquele capítulo e preservar as anotações permanentes do diário. Começar uma história do zero pode apagar todo o progresso. Se o jogo já oferece New Game Plus ou seleção de capítulos, siga as regras de reinício existentes para os enigmas também.

Se a consequência de uma escolha altera ramificações posteriores, inclua essas ramificações nos testes de conclusão do enigma. O diário pode mostrar a pista como “encontrada” enquanto a lógica de um final ainda consulta um indicador desatualizado. Manter uma única fonte para o estado narrativo e um único evento de conclusão facilita o diagnóstico.

Peça à IA uma alteração pontual e reversível

Em uma instrução de escopo bem definido, peça à IA que preserve o sistema atual de diálogos e finais e salve apenas os IDs dos enigmas resolvidos e as consequências narrativas já definidas. Especifique que as entradas parciais atuais devem ser descartadas ao fechar a cena e que a pista só pode ser concedida uma vez. Peça que a IA liste os arquivos alterados e explique como um salvamento antigo será carregado. Solicite o diff e os casos de teste antes de aceitar a alteração.

Revise o código em busca de gravações feitas fora do componente responsável pelo estado narrativo. Verifique se uma falha ao salvar não faz o jogo exibir incorretamente uma conclusão como permanente, se voltar à cena não concede a recompensa duas vezes e se um salvamento antigo sem o novo campo recebe um valor padrão definido de propósito. Mantenha uma cópia para reverter a alteração e teste a migração com uma cópia do salvamento.

Teste o retorno, a repetição do enigma e as ramificações

Inclua diferentes pontos da história na matriz de verificação. Os casos abaixo são propostas de teste para um projeto real. O exemplo fictício serve apenas para ilustrá-los.

CasoAçãoResultado esperado a verificar
Perfil novoComece sem um salvamento anteriorNenhum ID de enigma resolvido ou indicador de ramificação herdado indevidamente
Resolver e sairResolva um enigma, saia da cena e volteO estado de conclusão e a pista correspondente continuam consistentes
Tentativa parcialDigite parte de um código e saiaA tentativa é descartada ou retomada conforme o comportamento definido
RepetiçãoAbra novamente um enigma já resolvidoA apresentação funciona e a recompensa única é concedida apenas uma vez
Ramificação da históriaAvance até um diálogo ou final que dependa do resultadoA ramificação consulta a mesma consequência registrada no estado narrativo oficial
Salvamento antigoCarregue uma cópia descartável de um salvamento anterior à inclusão do novo campoA migração preserva as escolhas registradas e define um valor padrão seguro

Registre a versão da build, a plataforma, o arquivo de salvamento usado no teste, as etapas e os resultados esperados e observados. Se um caso falhar, corrija a transição de estado antes de ampliar a funcionalidade. Para comprovar que a migração do salvamento deu certo, teste no projeto real. Uma ilustração conceitual ou uma interface simulada não serve como comprovação.

A pista do farol fictício continua registrada quando o personagem volta. O objeto do enigma permanece disponível para outra interação, sem exibir a recompensa pela segunda vez.
Cena meramente ilustrativa. O comportamento ao voltar à cena e repetir o enigma deve ser verificado no projeto em questão.

Perguntas frequentes

Quais dados de um enigma devem ser salvos em um jogo de narrativa ramificada?

Em geral, salve os IDs dos enigmas resolvidos e as consequências que o sistema narrativo existente espera encontrar. Trate a sequência atual de entradas, os códigos digitados parcialmente e as dicas temporárias à parte, a menos que o jogo já permita retomar um enigma inacabado.

Como conectar um enigma a uma ramificação da história?

Use um ID estável para o enigma e atualize o indicador narrativo ou a consequência já existente no projeto por meio de um único evento de conclusão bem definido. Evite criar um sistema paralelo de ramificações que possa entrar em conflito com os diálogos, o estado das missões ou os finais.

Os jogadores devem poder jogar de novo um enigma já resolvido?

Decida se revisitar o enigma permite apenas rever sua apresentação, repetir a interação ou também alterar o estado narrativo. É possível mostrar o enigma novamente sem conceder a recompensa duas vezes. Documente o comportamento desejado antes de mudar o fluxo de conclusão.

Como salvar o progresso dos enigmas na Godot?

A documentação da versão estável da Godot recomenda user:// para dados persistentes do usuário e inclui um tutorial de salvamento que demonstra o uso de JSON para estados simples. Confira a plataforma de destino atual e as necessidades de armazenamento do projeto, pois as limitações de tipos de dados e codificação do JSON continuam valendo.

O que devo testar depois de implementar o salvamento do progresso dos enigmas?

Teste um perfil novo, a resolução de um enigma, o retorno à área central, o recarregamento, uma ramificação que dependa do resultado, o comportamento ao repetir o enigma e um salvamento antigo. Registre a build e as etapas. Um fluxo narrativo de exemplo, por si só, não comprova que um teste real foi executado.

Preserve a fonte de verdade da história

Em geral, o primeiro passo mais seguro é pequeno. Salve os IDs estáveis dos enigmas resolvidos, encaminhe a conclusão ao sistema narrativo existente e defina exatamente o que acontece ao revisitar ou reiniciar um enigma. Depois que o projeto real passar pelas verificações de retorno, ramificação, migração e recompensa, amplie o modelo de persistência apenas onde a narrativa exigir.

Para experimentar uma ideia em um protótipo separado que rode no navegador, use o SEELE AI Game Maker. Essa opção serve para criar um protótipo à parte, sem a promessa de corrigir um projeto existente.

Fontes

SEELE AI

Transforme este guia em um projeto jogável.

Comece com um briefing claro e evolua sua ideia no Workspace da Seele AI.

Começar a criar