Adicionar desbloqueios persistentes de cartas pode parecer uma simples alteração em um campo do arquivo de salvamento, mas um jogo narrativo também precisa preservar a ordem em que os jogadores descobrem as informações. Um capítulo pode estar desbloqueado enquanto suas cartas permanecem ocultas até o momento da revelação. Uma carta pode ser coletada sem ser incluída no baralho ativo. Modele esses estados separadamente antes de ampliar o fluxo de salvamento e, em seguida, teste as transições entre capítulos e o carregamento de salvamentos antigos.

Este guia é voltado a projetos narrativos com cartas que já existem. O arquivista, as cartas, as ramificações dos capítulos e as regras de revelação apresentados a seguir são exemplos didáticos fictícios. Adapte-os ao modelo de conteúdo e à política de spoilers do seu projeto.
Separe acesso, descoberta e seleção
Comece listando os estados relacionados às cartas e por quanto tempo cada um deve durar. “Desbloqueado” pode indicar que um capítulo está disponível. “Coletada” pode indicar que o jogador encontrou uma carta de evidência. “Revelada” pode significar que a história já mostrou a frente da carta ou seu texto. “Selecionada” pode indicar que a carta está em um baralho de leitura temporário ou em uma opção de diálogo. Se um único campo booleano tiver de responder às quatro perguntas, a interface e a lógica narrativa podem ficar fora de sincronia.
| Estado | O que significa | Pergunta típica sobre redefinição |
|---|---|---|
| Acesso | O jogador pode entrar em um capítulo ou em uma ramificação | O acesso é mantido ao iniciar uma nova sessão ou rejogar o capítulo? |
| Descoberta | Uma carta ou pista específica foi encontrada | Reiniciar o capítulo pode apagar o registro da descoberta? |
| Revelação | A história já mostrou o conteúdo da carta | Quando a ilustração ou o texto da carta pode aparecer nos menus? |
| Seleção | A carta está no baralho ativo ou faz parte da escolha atual | A seleção é apagada ao fim de uma cena ou de uma partida? |
No fictício Arquivo Meridiano, encontrar a carta da chave de latão a adiciona à coleção. Uma cena posterior revela a história por trás dela, e uma flag separada da ramificação controla o acesso ao capítulo. O baralho de leitura temporário é redefinido quando o jogador inicia outro capítulo. Essas regras ilustram decisões de design. Elas não descrevem comportamentos observados em um jogo.
Evite que os desbloqueios revelem partes futuras da história
Defina o que o jogador deve ver em cada área da interface, incluindo a lista de capítulos, a tela da coleção, a mão ou o baralho, as opções de diálogo e o menu para rejogar. Manter o acesso entre sessões dispensa a exibição do título, da imagem ou da explicação da carta em todas as telas. Um marcador de carta bloqueada ou ainda não descoberta pode preservar a estrutura da coleção sem expor detalhes da história.

Documente as regras de revelação junto aos IDs de conteúdo. Para cada ramificação, registre o evento anterior necessário, a flag que libera o acesso e a primeira cena em que a carta pode ser revelada. Depois, teste o recarregamento do jogo imediatamente antes e depois da revelação. Uma correção restrita à interface pode esconder um spoiler em um menu e ainda deixá-lo visível em uma fala de diálogo ou em uma miniatura gerada.
| Área da interface | Pergunta para evitar spoilers | O que verificar |
|---|---|---|
| Lista de capítulos | A disponibilidade do capítulo aparece sem exibir texto da história? | Confira os estados bloqueado, desbloqueado e disponível para rejogar |
| Coleção | As cartas ainda não descobertas ficam livres de spoilers? | Confira títulos, ilustrações, prévias e dicas de interface |
| Baralho ativo | Aparecem somente seleções válidas? | Entre e saia das cenas em cada ponto de revelação |
| Diálogo | Cartas futuras podem afetar escolhas anteriores? | Recarregue um salvamento antes e depois do evento de desbloqueio |
Prefira identificadores de conteúdo estáveis aos nomes de exibição das cartas. O texto e as ilustrações podem mudar ou ser localizados. Uma chave como archive_key_card deve continuar apontando para o mesmo registro narrativo. Centralize as regras de acesso no componente que já responde pela narrativa ou pelo conteúdo, evitando espalhar condições especiais por menus e cenas.
Amplie o modelo atual de salvamento e conteúdo
Identifique como o projeto já armazena capítulos, inventário, conquistas e escolhas ativas. Sempre que viável, reaproveite os slots de salvamento e o comportamento de redefinição existentes. Um novo “gerenciador de desbloqueio de cartas” pode entrar em conflito com o sistema narrativo que decide qual cena mostrar. Antes de criar outro campo, identifique qual sistema é a fonte de verdade para as flags de ramificação.
O tutorial de salvamento da documentação da versão estável do Godot mostra como decidir quais informações devem persistir e como serializar os dados relevantes. O exemplo é específico do motor e não prescreve um esquema narrativo. Se o projeto usa Godot, confirme a versão do motor em uso e siga a arquitetura de salvamento atual do projeto. Para outro motor, consulte a documentação correspondente e siga as convenções do projeto.
Defina explicitamente o que acontece quando um salvamento antigo não contém um novo campo de carta. O aumento da coleção, por si só, não justifica considerar desbloqueadas todas as cartas cujos dados estão ausentes. Decida se o acesso deve ser derivado de uma flag de capítulo existente, se o registro de descobertas deve começar vazio ou se é preciso executar uma migração única. Preserve o baralho ativo somente se a versão anterior do jogo já o tratava como um estado persistente.
Peça à IA que analise o fluxo narrativo antes de editar
Forneça à IA os IDs de conteúdo relevantes, o modelo de salvamento, as transições entre capítulos, os eventos de revelação e o comportamento atual de redefinição. Peça que ela mapeie onde os estados de acesso, descoberta e seleção são lidos e gravados. Antes da implementação, você pode pedir, em uma instrução específica, uma lista de arquivos, as alterações mínimas nos dados, os valores padrão para a migração, as verificações de spoilers e um plano para reverter as mudanças. Revise o diff para identificar pontos da interface que ainda usam o campo antigo.
Analise o fluxo de salvamento das cartas e da narrativa antes de editar. Mantenha separados o acesso aos capítulos, as cartas descobertas, o estado de revelação e a seleção ativa. Preserve a ordem atual das ramificações, o comportamento ao reiniciar capítulos, os IDs de localização e os slots de salvamento. Primeiro, identifique os componentes responsáveis por cada estado e os arquivos afetados. Depois, proponha a menor alteração possível, com valores padrão para salvamentos antigos, verificações de spoilers e etapas para reverter as mudanças. Só afirme que a persistência funciona depois de testá-la no projeto.
O catálogo da SEELE descreve a criação de jogos a partir de uma ideia escrita e apresenta categorias de jogos que podem ser jogados. Ele pode ajudar a explorar um conceito independente de narrativa com cartas ou a comunicar a direção de uma cena. O catálogo não confirma que a SEELE edite o código de um jogo narrativo existente ou migre os salvamentos dos jogadores.
Faça a migração com cuidado e preserve a possibilidade de recuperação
Use uma cópia de um salvamento antigo. Registre as versões antiga e nova do esquema, os campos adicionados, os valores padrão e o que acontece se um ID de carta deixar de existir. Mantenha uma cópia intacta para poder comparar o acesso e as descobertas antes e depois da migração. Se a leitura dos dados ou a migração falhar, siga o procedimento de recuperação já adotado no projeto para evitar sobrescrever o único salvamento com um estado incompleto.

O livro de registros fictício ajuda a explicar o que a equipe deve revisar, mas não comprova nada sobre um salvamento real. Após o carregamento, confira a lista de capítulos, a coleção, o baralho ativo e os diálogos no jogo. Inclua a versão do salvamento e o ID do capítulo no registro do teste para que, em caso de regressão, seja possível reproduzir o mesmo percurso.
Teste os pontos de revelação e redefinição
Teste com um perfil novo, logo antes do desbloqueio de uma ramificação, imediatamente depois, após rejogar um capítulo e a partir de uma cópia de um salvamento antigo. A tabela a seguir lista as verificações a fazer. Nenhum resultado é apresentado.
| Caso | Ação | O que verificar |
|---|---|---|
| Perfil novo | Abra as telas de capítulos e da coleção | Nenhum desbloqueio residual ou spoiler aparece |
| Evento de desbloqueio | Acione uma condição de acesso à ramificação | Somente o estado de acesso previsto muda |
| Descoberta de carta | Encontre uma carta da história ou de evidência | A coleção é atualizada uma única vez com o ID correto |
| Revelação em uma cena | Avance até a revelação da carta na história | O conteúdo da carta fica visível no momento certo |
| Reinício do capítulo | Rejogue ou reinicie o capítulo | O acesso persistente e a seleção temporária seguem as regras |
| Salvamento antigo | Carregue uma cópia de um salvamento de uma versão anterior | A migração preserva o conteúdo conquistado e mantém ocultos os detalhes futuros |
Registre a build, o esquema de salvamento, o capítulo, o ID da carta, a ação, o estado esperado e o estado observado. Se aparecer a carta errada, determine se o problema está na migração, na avaliação das condições da ramificação, na filtragem da coleção, no momento da revelação ou no cache da interface antes de corrigir vários sistemas.
Perguntas frequentes
Quais desbloqueios de cartas devem persistir em um jogo narrativo?
Preserve os desbloqueios da história ou da coleção que devem continuar disponíveis entre capítulos e sessões. Mantenha separados o baralho ativo, as escolhas temporárias de draft e os efeitos que duram uma única partida, a menos que o design preveja preservá-los. Use IDs de conteúdo estáveis e deixe claras para o jogador as regras de redefinição.
As cartas de evidência coletadas e os desbloqueios da história devem usar a mesma flag?
Em geral, são estados distintos. Um jogador pode descobrir uma carta sem desbloquear o capítulo correspondente ou desbloquear um capítulo sem selecionar a carta. Modele esses estados separadamente quando o jogo precisar exibi-los, filtrá-los ou redefini-los de forma independente. Sempre que possível, reutilize o modelo de conteúdo atual do projeto.
Como evitar spoilers ao salvar o progresso relacionado às cartas da história?
Separe o que está desbloqueado do que já foi revelado no capítulo atual ou na interface. Uma flag persistente pode conceder acesso enquanto a interface respeita a ordem das revelações da história. Teste o recarregamento nas transições entre capítulos e verifique se as prévias, as telas da coleção e os diálogos ocultam o conteúdo futuro até o momento previsto.
Como migrar salvamentos antigos de cartas para um novo sistema de desbloqueio?
Carregue uma cópia de um salvamento antigo, mapeie os identificadores de cartas conhecidos para o novo esquema e defina valores padrão para os campos ausentes. Preserve o conteúdo conquistado e, quando previsto pelo design, o baralho selecionado pelo jogador. Registre a versão da migração e mantenha um original que possa ser restaurado até que os testes no projeto real passem.
Um arquivo fictício pode comprovar que os desbloqueios persistentes de cartas funcionam?
Não. Um exemplo fictício pode esclarecer os grupos de cartas e as regras de revelação. Para verificar a persistência, é preciso salvar, recarregar e mudar de capítulo na build que está sendo testada. Registre as versões da build e do salvamento, as cartas que deveriam estar desbloqueadas e o que o jogo exibiu após cada ação.
Coloque a persistência a serviço da história
Mantenha o acesso, a descoberta, a revelação e a seleção ativa alinhados à ordem prevista pela narrativa. Reutilize uma única fonte de verdade, faça a migração a partir de uma cópia do salvamento e teste cada transição entre capítulos em que o conteúdo muda. Assim, a equipe pode ampliar a progressão com cartas sem perder o progresso narrativo conquistado nem antecipar uma revelação futura.
Para explorar um conceito independente de jogo narrativo com cartas, experimente o SEELE AI Game Maker. Ele serve como ponto de partida para desenvolver o conceito. A migração de salvamentos está fora dessa finalidade.


