Testes & Depuração » Menu de Depuração
March 13, 2026

Menu de Depuração

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.

O Menu de Depuração é uma ferramenta de testes que permite inspecionar e modificar o estado da sua história enquanto a pré-visualiza no editor. Ele permite ver registros, editar variáveis e simular mudanças de inventário para testar como sua história reage em diferentes condições.

Você pode abrir o Menu de Depuração durante a Pré-visualização da História selecionando o ícone Depurar.

1. Visão geral

O Menu de Depuração contém abas focadas nos principais sistemas de pré-visualização:

  • Registros: Exibe eventos da história, ações e mensagens do sistema durante a pré-visualização.
  • Inventário: Permite ver e modificar quantidades de itens usados na sua história.
  • Variáveis: Permite ver e alterar os valores de variáveis em tempo real.
  • Eventos: Mostra o estado dos eventos e ajuda a verificar quais eventos da história estão ativos durante a pré-visualização.
  • Temporizadores: Mostra o estado dos temporizadores, incluindo contagens regressivas ativas e comportamento de temporizadores recorrentes.

Quaisquer alterações feitas através do Menu de Depuração afetam apenas a sessão de pré-visualização atual. Elas não são salvas na sua história e serão resetadas quando você reiniciar a pré-visualização.

2. Registros

2. Registros

A aba Registros mostra o que acontece nos bastidores enquanto sua história roda. Ela ajuda a acompanhar o fluxo da história, testar a lógica e entender quando certos eventos ocorrem.

O que você pode ver:

  • Ativações de gatilhos e resultados de ações
  • Progresso de diálogos e checagens de condições
  • Alterações de variáveis ou itens causadas por escolhas do jogador

A aba Registros é principalmente uma ajuda para contar a história que ajuda os Bards a confirmar que a lógica da história roda na ordem esperada. Ela não mostra erros técnicos ou de tempo de execução.

3. Inventário

3. Inventário

A aba Inventário lista todos os itens disponíveis na história, não apenas os que o jogador está carregando no momento. Você pode ajustar suas quantidades livremente para testar criação, quebra-cabeças ou condições baseadas em itens.

Você pode:

  • Adicionar ou remover quantidades de qualquer item usando os botões + / −.
  • Pesquisar itens por nome.

Isso permite testar cenários como:

  • Criar novos itens usando receitas.
  • Verificar se eventos disparam quando um item está presente.
  • Verificar caminhos da história que dependem de objetos coletados.

4. Variáveis

4. Variáveis

A aba Variáveis mostra todas as variáveis definidas na sua história e seus valores atuais. Você pode modificá-las para simular decisões do jogador ou testar caminhos alternativos da história.

Você pode:

  • Alternar bandeiras (true/false).
  • Alterar números diretamente.
  • Editar valores de texto.
  • Resetar variáveis individuais.

A lista de variáveis é atualizada automaticamente quando novas variáveis são criadas ou alteradas.

5. Fluxo de testes

O Menu de Depuração foi projetado para testes criativos, não para depuração técnica. Ele ajuda você a verificar que:

  • Escolhas e variáveis se comportam como esperado.
  • Itens e lógica de criação funcionam corretamente.
  • Ramificações da história são desbloqueadas nas condições certas.
  • Eventos e temporizadores disparam nos momentos esperados.
  • Transições de estado do jogador são consistentes.

Você pode combinar o Menu de Depuração com o Sistema de Verificações do Editor para um fluxo completo de validação antes do lançamento.

6. Boas práticas

  • Use Registros para rastrear o fluxo da história e confirmar a ordem dos eventos.
  • Use Variáveis para pular diretamente para ramos específicos e testar rapidamente.
  • Use Inventário para testar criação ou restrições por item sem replayar cenas iniciais.
  • Use Eventos e Temporizadores para confirmar comportamento de tempo, gatilho e contagem regressiva.
  • Resete com frequência para verificar se sua história funciona corretamente a partir de um estado limpo.

O Menu de Depuração te dá controle total sobre os testes, permitindo explorar cada ramo, decisão e resultado antes que sua história chegue aos Dreamers.

Documentação