Em um extraction shooter, o sistema de progressão precisa preservar o sentido de “extrair”. Se todas as incursões renderem as mesmas recompensas permanentes, independentemente do resultado, o risco pode desaparecer. Se o salvamento for acionado duas vezes no mesmo ponto, a carga pode ser duplicada no inventário. Antes de adicionar uma camada de progressão, defina quais dados pertencem ao perfil, à incursão atual, ao inventário e ao resultado já apurado.

Este guia usa um protótipo fictício para ilustrar as decisões. Nenhum projeto, build, extração ou teste de jogo real está representado aqui. O objetivo é propor um plano de escopo restrito que um assistente de IA possa implementar no jogo existente, preservando o ciclo das incursões.
Separe os estados do perfil, do inventário, da incursão e do resultado
Comece com quatro categorias. O estado do perfil pode incluir reputação ou desbloqueios permanentes. O inventário guarda os itens protegidos entre incursões. O estado da incursão inclui o objetivo atual, a carga transportada e os danos temporários. O estado do resultado registra se houve extração, falha ou abandono. Deixe essas distinções explícitas. Caso contrário, uma pausa ou transição de cena pode transformar por engano um saque ainda não extraído em progresso permanente.
| Categoria | Exemplo | Quando atualizar |
|---|---|---|
| Perfil | Reputação, desbloqueios permanentes | Quando a regra de progressão existente conceder a recompensa |
| Inventário | Armas protegidas, carga extraída | Depois que a lógica responsável pela incursão confirmar o resultado |
| Incursão atual | Saque transportado, situação do objetivo, vida | Enquanto a incursão estiver ativa |
| Resultado | Extração, falha, abandono | Uma única vez, no momento em que o resultado for definido |
No exemplo fictício de Greyline Depot, o jogador pode carregar uma maleta de amostras durante a incursão. Se a extração for bem-sucedida, a maleta vai para o inventário. Se a incursão falhar, a carga transportada é perdida, mas a reputação conquistada em um objetivo persistente separado pode ser mantida. Esse é apenas um dos modelos possíveis. Documente as regras de risco do projeto real antes de alterar o fluxo de dados.
Mapeie o ciclo de vida das incursões existentes
Identifique onde a incursão começa, como os objetivos são acompanhados, onde o acionamento da extração é processado, como a falha é tratada e quando o jogador retorna à base. Mapeie o script ou serviço responsável por cada transição. Peça à IA que explique esse fluxo antes de modificar o código. Guarde uma cópia do projeto e um arquivo de salvamento de perfil descartável para comparar o comportamento com segurança.
Use o evento de resultado existente, caso haja um. Evite adicionar um segundo manipulador de extração que escute o mesmo acionamento e faça sua própria atualização do inventário. O estado final deve ser gravado uma única vez, depois que o jogo souber o resultado. Se já houver um modelo de autoridade na rede ou requisições assíncronas, preserve esse modelo e evite atalhos que funcionem apenas localmente.

Torne idempotente o processamento das recompensas
Recompensas duplicadas costumam surgir nas transições. A animação de extração é acionada, a tela de resultados se abre e um recarregamento executa o mesmo callback outra vez. Implemente a gravação de modo que processar o resultado de uma incursão mais de uma vez não adicione a mesma carga duas vezes. Um ID estável para a incursão ou um marcador explícito de resultado já processado pode ajudar, dependendo da arquitetura do projeto.
Defina a ordem das operações. Primeiro, obtenha o resultado definitivo da lógica responsável pela incursão. Em seguida, calcule o que é mantido, o que é perdido e qual progresso permanente é obtido. Valide os IDs e as quantidades dos itens. Grave o perfil e o inventário em uma única atualização coerente. Por fim, mostre o resumo e retorne à base. Se o salvamento falhar, o jogo deve informar a falha e seguir uma política de recuperação que o projeto consiga oferecer. Ele não deve exibir silenciosamente um resultado de sucesso que nunca foi gravado.
Evite prometer que o salvamento em um arquivo local oferece a mesma atomicidade de um banco de dados. Use o mecanismo de armazenamento já compatível com o motor e a plataforma, mantenha uma cópia recuperável quando for apropriado e teste o comportamento em caso de interrupção. A documentação da versão estável do Godot recomenda user:// para dados persistentes do usuário e informa que o caminho permite gravação em projetos exportados. A Unity documenta Application.persistentDataPath para dados mantidos entre execuções, com locais específicos para cada plataforma. Essas referências descrevem os caminhos. Elas não oferecem garantias sobre transações, backups ou sincronização na nuvem.
Peça à IA uma alteração de escopo limitado
Descreva as regras em linguagem simples. Preserve o comportamento dos objetivos, dos inimigos, da movimentação, do combate e da extração. Apenas uma extração bem-sucedida transfere o saque transportado para o inventário. Em caso de falha, aplique as perdas conforme as regras atuais do jogo. As recompensas persistentes do perfil devem usar o sistema existente, e processar o mesmo resultado duas vezes não pode duplicar a carga. Peça à IA que liste os arquivos alterados, as premissas adotadas, os efeitos da migração e os passos para reverter a alteração.
Revise o fluxo de código que calcula o saque, além do resumo exibido na interface. Confira se o resumo lê o resultado gravado, sem recalcular as recompensas por conta própria. Verifique se uma incursão malsucedida não pode deixar um marcador de “sucesso” desatualizado e se o retorno à base não reabre uma incursão já encerrada.
Se o jogo já usa conjuntos de equipamentos ou níveis de raridade para os itens, mantenha os identificadores estáveis e valide os limites do inventário. Uma nova camada de progressão não deve apagar silenciosamente itens presentes em salvamentos anteriores. Teste uma cópia de um arquivo de salvamento antigo e decida como tratar IDs de itens desconhecidos ou removidos antes de sobrescrever qualquer perfil real.
Teste sucesso, falha e transições interrompidas
Use uma matriz que cubra tanto os resultados das incursões quanto a recuperação do estado. As linhas a seguir apresentam verificações sugeridas. Elas não relatam resultados do protótipo fictício.
| Caso | Ação | Comportamento esperado a verificar |
|---|---|---|
| Perfil novo | Inicie sem um perfil anterior | O inventário e os desbloqueios iniciais seguem as regras documentadas |
| Extração bem-sucedida | Leve dois itens conhecidos e conclua a extração | Cada item entra no inventário uma única vez, e o estado da incursão é encerrado |
| Incursão malsucedida | Carregue saque e acione o resultado de falha existente | As regras de perda são aplicadas sem apagar o progresso do perfil que não depende da incursão |
| Resultado repetido | Dispare novamente o mesmo evento de resultado em uma cópia de teste segura | A carga e a reputação não são duplicadas |
| Retorno interrompido | Teste uma interrupção segura perto da transição para o resultado | A recuperação segue a política definida, e o resultado continua compreensível |
| Salvamento antigo | Carregue uma cópia anterior à inclusão dos campos de progressão | Os itens conhecidos do inventário são preservados ou é exibido um erro de migração claro |
Registre a versão do jogo, a plataforma, o perfil usado no teste, o resultado da incursão, os passos, o resultado esperado e o resultado observado. Repita o teste na build de destino, pois o caminho de armazenamento e o ciclo de vida podem variar conforme a plataforma. Um diagrama, uma simulação da tela de resultados ou uma lista de itens de exemplo não substitui um teste real de extração.

Perguntas frequentes
O que deve persistir em um protótipo de extraction shooter?
Defina separadamente o que pertence ao perfil, ao inventário, à incursão atual e à carga extraída. Uma primeira versão pode salvar a reputação e os objetivos concluídos e guardar o saque da incursão somente após uma extração bem-sucedida. Explicite a regra de recompensas para que os jogadores entendam o que é mantido.
Quando os itens extraídos devem entrar no inventário?
Grave o resultado assim que o fluxo existente de encerramento da incursão confirmar a extração. Mantenha um identificador estável para a incursão ou para o resultado, de modo que uma transição de cena repetida não adicione a mesma carga duas vezes. Ter um único responsável pelo resultado facilita a auditoria e a recuperação da gravação.
Os equipamentos de uma incursão malsucedida devem ser mantidos na progressão?
Siga o modelo de risco definido para o protótipo. Se o design prevê a perda dos equipamentos transportados em caso de falha, aplique essa perda de forma explícita e preserve o progresso do perfil que não depende da incursão. Evite que um erro de salvamento transforme silenciosamente uma falha em extração. Deixe a regra de falha clara nas notas de design e nos textos apresentados ao jogador.
Como adicionar progressão sem reescrever o ciclo das incursões?
Centralize o processamento dos resultados existentes de extração e falha em um único ponto de atualização da progressão. Mantenha os componentes responsáveis pelos objetivos, inimigos, movimentação e combate. Peça à IA que mostre um diff pequeno por arquivo e indique como reverter a alteração. Esse ponto único ajuda a evitar que um segundo componente assuma a responsabilidade pelo combate ou pelos objetivos.
O que devo testar antes de manter a mudança na progressão?
Teste um perfil novo, uma extração bem-sucedida, uma extração malsucedida, uma interrupção durante o processamento do resultado, uma transição duplicada, o acesso ao inventário após o retorno e um salvamento antigo. Registre a build, a plataforma e os resultados observados. Use o registro da execução real como evidência, pois o plano de testes por si só não comprova o comportamento. Identifique os exemplos como hipotéticos.
Preserve o sentido da extração
Concentre a primeira implementação no processamento do resultado e no ponto em que os itens entram no inventário. Se o projeto consegue explicar exatamente o que é mantido após uma extração bem-sucedida, o que se perde em caso de falha e como se impede que o mesmo resultado seja aplicado duas vezes, a camada de progressão tem regras que podem ser revisadas. Verifique essas regras no jogo real antes de ampliar a implementação.
Para experimentar uma ideia de protótipo separado que possa ser jogado no navegador, use o SEELE AI Game Maker. O convite é para criar outro protótipo. O recurso não serve para corrigir um projeto existente.


