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.

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.
| Estado | Exemplo | O que deve ser preservado? |
|---|---|---|
| Evidência | ID de uma fotografia, de uma anotação ou de uma pista física | A evidência permanece no inventário do caso? |
| Resultado do enigma | Fechadura de latão aberta | Ao voltar, o jogador pula o enigma ou o vê de novo? |
| Tentativa de dedução | Disposição atual das pistas | Deve ser possível retomar uma teoria incompleta? |
| Conclusão | Marcador de ramificação ou desfecho do caso | Qual 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.

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.

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ário | Ação | O que verificar |
|---|---|---|
| Novo caso | Começar com um perfil sem progresso | Nenhuma pista ou conclusão antiga aparece |
| Resolução de um enigma | Resolver um enigma que revela uma pista | A evidência é adicionada uma única vez e o estado da ramificação é atualizado |
| Saída e retorno | Sair da sala e entrar novamente | O status do enigma e o quadro do caso seguem a regra definida |
| Tentativa parcial | Sair antes de concluir a tentativa | A tentativa é reiniciada ou retomada conforme o comportamento especificado |
| Repetição | Interagir novamente com um enigma resolvido | Nenhuma evidência é duplicada e nenhuma conclusão imprevista é registrada |
| Caso antigo | Carregar uma cópia dos dados salvos em uma versão anterior | As 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.


