Como manter os enigmas resolvidos sem perder a lógica do caso

Use IA para salvar o progresso dos enigmas em um jogo de detetive. Preserve as evidências, as cadeias de pistas, as conclusões dos casos e a integridade dos dados salvos.

Seele Editorial TeamAtualizado 16 de novembro de 2026

Um jogo de detetive deve guardar as evidências que o jogador conquistou sem precisar preservar todas as teorias inacabadas. Enigmas resolvidos, pistas coletadas, tentativas de dedução em andamento e conclusões do caso são estados distintos. Tratar tudo como um bloco único pode duplicar evidências ou permitir que uma teoria desatualizada sobrescreva o estado oficial da história.

Um detetive fictício examina as evidências coletadas em um escritório no porto, com um enigma de latão já resolvido ao lado do quadro do caso.
Lantern Pier é um mistério fictício criado para ilustrar a explicação. Não corresponde a um caso real nem a um teste.

Este guia descreve um mistério fictício ambientado em um porto. Nenhum projeto, investigação ou processo de migração de dados salvos foi testado. O objetivo é salvar o progresso dos enigmas e preservar o fluxo de evidências e conclusões que já funciona.

Separe evidências, enigmas resolvidos, tentativas e conclusões

Liste o que o jogo já registra. Uma evidência pode ter um ID estável e uma origem. Um enigma pode ter um indicador de que foi resolvido. Um quadro de deduções pode conter uma disposição temporária de pistas. Um caso pode registrar uma conclusão ou o estado de um capítulo. Decida quais valores são mantidos quando o jogador sai de uma sala, fecha o jogo, reinicia um capítulo ou começa um novo caso.

EstadoExemploO que deve ser preservado?
EvidênciaID de uma fotografia, de uma anotação ou de uma pista físicaA evidência permanece no inventário do caso?
Resultado do enigmaFechadura de latão abertaAo voltar, o jogador pula o enigma ou o vê de novo?
Tentativa de deduçãoDisposição atual das pistasDeve ser possível retomar uma teoria incompleta?
ConclusãoMarcador de ramificação ou desfecho do casoQual sistema narrativo controla esse estado?

No caso fictício de Lantern Pier, resolver o enigma da fechadura registra um ID estável e acrescenta uma pista ao quadro de evidências. A disposição temporária das pistas usadas para montar uma teoria é desfeita quando o detetive sai da sala. A conclusão final continua sob o controle do sistema que já gerencia o estado do caso. Essas regras são exemplos e não descrevem um jogo de detetive real.

Integre a resolução dos enigmas ao sistema de casos existente

Mapeie o caminho entre interagir com um enigma, coletar a pista associada a ele e desbloquear um diálogo ou uma conclusão. Identifique qual sistema controla os IDs das evidências, os marcadores dos capítulos e os finais. Peça à IA que mapeie esse fluxo antes de alterar o código. Mantenha um único sistema responsável pelo estado do caso para evitar que um inventário separado de enigmas entre em conflito com o quadro de evidências.

Ao resolver um enigma, emita um único evento de conclusão com o ID estável do enigma e a consequência prevista. O sistema de casos pode verificar se o evento já foi registrado, adicionar a pista uma única vez e desbloquear a ramificação que depende dela. Repetir uma animação ou recarregar uma cena não deve conceder a mesma evidência de novo.

Use IDs para identificar as pistas, independentemente do texto exibido. Assim, você pode renomear ou traduzir uma pista sem alterar sua chave nos dados salvos. Se uma pista ou um enigma for removido na próxima versão, decida se vai migrar o ID, ocultar o item ou manter o registro antigo nos casos já concluídos.

As pistas coletadas e um enigma resolvido estão ligados a um único quadro do caso, onde as conclusões ficam separadas de uma tentativa temporária de formular uma teoria.
Um único sistema de casos deve receber os eventos de conclusão dos enigmas e controlar as consequências narrativas.

Defina o que significa revisitar um enigma

Um jogador pode querer voltar a um enigma resolvido para rever a animação, tentar resolvê-lo novamente, explorar uma ramificação alternativa ou reiniciar o capítulo. São ações diferentes. É possível repetir a animação sem alterar o estado das evidências, enquanto uma nova ramificação pode gerar um registro próprio de conclusão. Defina quais comportamentos o jogo de fato permite.

Preste atenção ao reinício de capítulos e à opção Novo Jogo. Se reiniciar um capítulo apagar o progresso dos enigmas daquele capítulo e preservar o diário, deixe essa regra explícita. Se começar um novo caso limpar todos os dados do caso, garanta que isso preserve os desbloqueios do perfil que não têm relação com ele. Sempre que possível, reaproveite o fluxo de reinício existente para evitar regras de exclusão exclusivas para enigmas.

Para o progresso online ou em vários dispositivos, seria preciso projetar um mecanismo específico de resolução de conflitos. Este artigo parte do modelo atual do projeto, que salva os casos localmente. Só indique que há sincronização entre dispositivos se o jogo já oferecer esse recurso e se o comportamento tiver sido testado.

Controle a versão dos dados salvos e preserve os casos antigos

Use o caminho de armazenamento e o método de serialização que o projeto suporta. A documentação da versão estável do Godot descreve user:// como um caminho com permissão de escrita para dados persistentes e inclui exemplos de como salvar em arquivos. Confira a plataforma de destino e a versão atual do motor. O formato dos dados salvos também precisa de um esquema com controle de versão, valores padrão para campos ausentes e um procedimento de recuperação para dados malformados.

Teste a migração em uma cópia de um caso antigo. Compare os IDs das evidências, os IDs dos enigmas resolvidos, as entradas do diário e os marcadores de conclusão antes e depois do carregamento. Antes de adotar “resolvido” ou “não resolvido” como valor padrão do novo campo, avalie como isso afeta o estado da história para quem já jogava.

Durante o desenvolvimento, mantenha um registro simples com o ID do caso, o ID do enigma, o evento recebido, a evidência adicionada, o marcador de conclusão alterado e a versão dos dados salvos. Isso ajuda a descobrir se o estado parou de ser atualizado ou se a interface está apenas exibindo uma versão antiga do quadro.

Registre a origem de cada pista

Quando um enigma desbloquear uma evidência, registre de onde ela veio se o sistema de casos usar essa relação. O ID de uma pista pode apontar para a sala, a conversa ou o objeto que a revelou. Isso ajuda o diário a explicar como o detetive obteve a informação e facilita a depuração de uma ramificação que depende de várias pistas.

A ilustração ou uma imagem gerada da evidência não substitui o registro real da pista. Os dados salvos devem conter os IDs estáveis e as consequências para o caso que o jogo efetivamente consulta. Se o jogador puder descartar ou revisitar evidências, siga o comportamento que o diário já oferece e evite criar um segundo inventário.

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

Defina os requisitos para o assistente. Preserve a coleta de evidências, a ordem dos diálogos, o reinício de capítulos, os finais e os controles dos enigmas. Salve apenas os IDs dos enigmas resolvidos e as consequências que foram definidas. Mantenha as tentativas parciais temporárias. Liste os arquivos alterados, o comportamento da migração e os passos para reverter as mudanças. Peça um plano para a alteração antes que o assistente edite o código.

Revise as alterações no código em busca de evidências gravadas em duplicidade, textos de exibição usados como IDs e conclusões armazenadas tanto no enigma quanto no gerenciador da história. Guarde os dados salvos de um caso conhecido para usar como base em testes de regressão. Se a IA alterar a lógica do final para que o enigma seja considerado resolvido, separe essa mudança do pedido de persistência e revise-a por conta própria.

O detetive fictício volta ao mesmo quadro do caso e encontra as pistas coletadas, mas a disposição temporária usada para montar uma teoria foi desfeita.
O exemplo de recarregamento é ilustrativo. Verifique na versão real do jogo quais dados são mantidos e quais são redefinidos.

Verifique a coleta, o retorno, a repetição e a migração

Os testes a seguir são propostas. Nenhum deles foi realizado em Lantern Pier.

CenárioAçãoO que verificar
Novo casoComeçar com um perfil sem progressoNenhuma pista ou conclusão antiga aparece
Resolução de um enigmaResolver um enigma que revela uma pistaA evidência é adicionada uma única vez e o estado da ramificação é atualizado
Saída e retornoSair da sala e entrar novamenteO status do enigma e o quadro do caso seguem a regra definida
Tentativa parcialSair antes de concluir a tentativaA tentativa é reiniciada ou retomada conforme o comportamento especificado
RepetiçãoInteragir novamente com um enigma resolvidoNenhuma evidência é duplicada e nenhuma conclusão imprevista é registrada
Caso antigoCarregar uma cópia dos dados salvos em uma versão anteriorAs pistas e os marcadores da história permanecem consistentes

Registre a versão da compilação, o ID do caso, o ID do enigma, a versão dos dados salvos, os passos, o resultado esperado e o resultado observado. Confira tanto o que aparece no diário quanto o comportamento da ramificação no jogo. Uma simulação do quadro de evidências não comprova que uma pista salva desbloqueia o final correto.

Perguntas frequentes

Que progresso deve ser salvo em um jogo de detetive?

Salve os IDs das evidências coletadas e dos enigmas resolvidos, além das consequências para o caso das quais a narrativa depende. Trate uma tentativa parcial de dedução, a disposição escolhida para o quadro ou uma dica temporária como estados separados, a menos que o jogo já permita retomá-los. Use a terminologia de casos e o formato de registro já adotados no projeto.

Como um enigma resolvido deve afetar o quadro do caso?

Envie um único evento de conclusão ao sistema que já controla o estado do caso. Ele pode registrar o ID do enigma, desbloquear a pista ou a conclusão prevista e impedir que uma interação repetida conceda a mesma evidência duas vezes. Faça com que o quadro e o modelo de dados do caso consultem o mesmo sistema.

Os jogadores devem poder revisitar um enigma de detetive?

Decida se revisitar o enigma serve para rever a apresentação, fazer uma nova tentativa ou abrir outra ramificação do caso. Repetir uma animação não deve duplicar evidências nem sobrescrever uma conclusão anterior sem aviso. Documente esse comportamento para que os jogadores saibam o que é reiniciado. Mantenha o resultado salvo separado de uma nova tentativa em outra ramificação.

Onde salvar as evidências e o estado dos enigmas?

Use o caminho de dados persistentes e o modelo de salvamento com controle de versão que o projeto suporta. A documentação da versão estável do Godot descreve user:// e o salvamento em arquivos. Confirme a versão atual do motor e a plataforma de destino antes de escolher um formato. Verifique esses campos no projeto real e na plataforma de destino.

O que devo testar depois de implementar a persistência das deduções?

Teste um caso novo, a coleta de uma pista, a resolução de um enigma, o retorno ao quadro de evidências, o recarregamento, a repetição e o carregamento de dados salvos antigos. Registre o caso e a compilação usados de fato. Uma cadeia de pistas fictícia não é um resultado de teste. Inclua o ID do caso e a versão dos dados salvos no registro do que foi observado.

Mantenha o estado do caso em um só lugar

Salve os resultados estáveis dos enigmas e os efeitos das evidências por meio do sistema que já controla a investigação. Mantenha as tentativas parciais temporárias, a menos que o jogo permita retomá-las explicitamente. Depois, verifique no projeto real o que acontece ao voltar, ao revisitar enigmas e ao carregar dados salvos antigos, antes de expandir o sistema de pistas.

Se você quiser experimentar uma ideia em um protótipo separado que rode no navegador, use o SEELE AI Game Maker. O convite é para criar um protótipo à parte, sem modificar o sistema de casos de um jogo de detetive 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