Testes & Depuração » Problemas Comuns
November 2, 2025

Problemas Comuns

Em andamento

Esta documentação ainda está sendo expandida e refinada. Recursos, capturas de tela e descrições podem mudar até o lançamento público do Talescape. Se algo estiver confuso ou você precisar de ajuda, pergunte no Discord oficial do Talescape. Temos prazer em esclarecer ou atualizar as páginas quando necessário.

Mesmo histórias bem estruturadas às vezes podem falhar em verificações ou se comportar diferente do esperado. Este artigo lista os problemas mais comuns encontrados durante os testes e a publicação, junto com suas causas prováveis e soluções.

1. Backgrounds ou Mídia Ausentes

Sintoma: Uma cena carrega com fundo em branco ou preto.
Causa: A imagem de fundo foi deletada ou não foi atribuída.

Solução:


2. Cenas Órfãs

Sintoma: Uma cena nunca é alcançada ao jogar a história.
Causa: Nenhum gatilho ou transição leva a essa cena.

Solução:

  • Use as Verificações de Cena para identificar cenas não usadas.
  • Crie uma transição ou ação de diálogo que a conecte, ou remova-a se estiver obsoleta.

3. Diálogos Inalcançáveis

Sintoma: Algumas opções de diálogo nunca aparecem.
Causa: A opção de diálogo está atrás de condições que nunca são satisfeitas.

Solução:

  • Reverifique as variáveis ou flags relacionadas.
  • Use o Menu de Debug para alternar valores de variáveis e confirmar a visibilidade.

4. Descrições ou Capturas de Tela Ausentes

Sintoma: O lançamento falha nas verificações do Marketplace.
Causa: A história não tem os metadados obrigatórios (por exemplo, tamanho da descrição, tags, capturas de tela).

Solução:

  • Abra Configurações da História → Marketplace.
  • Adicione uma descrição (pelo menos 300 caracteres), três capturas de tela e três tags.

5. Classificação Etária ou Avisos de Conteúdo Incorretos

Sintoma: A história é sinalizada ou rejeitada durante a revisão.
Causa: O grupo etário selecionado não corresponde ao conteúdo da história.

Solução:


6. História Não Finaliza Corretamente

Sintoma: A história continua indefinidamente ou entra em loop inesperado.
Causa: O capítulo final não tem um gatilho de conclusão.

Solução:

  • Adicione uma ação Sucesso do Capítulo ao final do último capítulo.
  • Teste com a Pré-visualização da História para confirmar que os créditos aparecem corretamente.

7. Itens Não Usados ou Quebrados

Sintoma: Itens existem mas não têm uso ou efeito visível.
Causa: Receitas de crafting faltando, gatilhos de item ou checagens de inventário ausentes.

Solução:

  • Verifique se cada item é referenciado em um evento, receita de crafting ou condição.
  • Remova itens não usados para manter o projeto limpo.

8. Incompatibilidade de Variáveis

Sintoma: A lógica não se comporta como esperado (ramificações erradas disparam).
Causa: Tipo de variável errado ou valor incorreto definido.

Solução:

  • Reavalie as ações que modificam a variável.
  • Use o Menu de Debug → Variáveis para confirmar os valores em tempo real.

9. Transições de Cena Não Funcionando

Sintoma: O jogador fica preso após uma escolha ou clique.
Causa: O gatilho ou condição ligado à transição de cena é inválido.

Solução:

  • Verifique se as Ações contêm um passo válido “Ir para Cena”.
  • Use a aba Logs no Menu de Debug para confirmar a ativação do gatilho.

10. Verificações Não Passam Após Correção

Sintoma: Um problema continua aparecendo como “Falhado” após ser consertado.
Causa: Os resultados das verificações estão em cache.

Solução:

  • Clique em Executar Verificações novamente para atualizar os resultados da validação.
  • Garanta que todo o conteúdo relacionado foi salvo antes de executar novamente.

11. Lançamento Não Avança para Revisão Manual

Sintoma: O lançamento permanece em “Revisão Automatizada”.
Causa: Problemas de nível Falha não resolvidos nas Verificações.

Solução:

  • Abra Verificações e resolva todas as falhas listadas.
  • Reenvie o lançamento assim que a história passar na validação.

12. Flags de Conteúdo (IA) Ausentes ou Incorretas

Sintoma: A história passa nas verificações mas falha na moderação.
Causa: Assets gerados por IA não foram divulgados.

Solução:

  • Reabra Configurações da História → Conteúdo e habilite as flags de IA relevantes (por exemplo, “Imagens de IA” ou “Vozes de IA”).
  • Reenvie o lançamento.

13. Alterações de Colaboradores Não Refletidas

Sintoma: Um colaborador não consegue editar ou acessar certas partes.
Causa: Permissões não foram atualizadas após adicionar o colaborador.

Solução:

  • Abra Configurações da História → Colaboradores.
  • Garanta que todas as permissões relevantes estão habilitadas e clique em Salvar Alterações.

14. Boas Práticas Gerais

  • Sempre execute as Verificações do Editor antes de criar um lançamento.
  • Use o Menu de Debug para confirmar a lógica e o comportamento do inventário.
  • Mantenha os metadados (descrição, classificação etária, tags) completos e atualizados.
  • Refaça as verificações após qualquer edição significativa para garantir conformidade.

Estes são os problemas mais frequentes reportados por Bards e revisores. Corrigi-los cedo garante que sua história passe na validação sem problemas e chegue aos Dreamers sem atraso.

Próximo: Colaboração

Documentação