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

Menu de Debug

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 Debug Menu é uma ferramenta de testes que permite inspecionar e modificar o estado da sua história enquanto a pré-visualiza no editor. Ele permite ver logs, editar variáveis e simular mudanças no inventário para testar como sua história reage em diferentes condições.

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

1. Visão geral

O Debug Menu contém três abas principais:

  • Logs: Exibe eventos da história, ações e mensagens do sistema durante a pré-visualização.
  • Inventory: Permite ver e modificar quantidades de itens usados na sua história.
  • Variables: Permite visualizar e alterar valores de variáveis em tempo real.

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

2. Logs

2. Logs

A aba Logs mostra o que acontece por trás das cenas enquanto sua história roda. Ela ajuda a acompanhar o fluxo da narrativa, 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ção
  • Mudanças em variáveis ou itens causadas por escolhas do jogador

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

3. Inventory

3. Inventory

A aba Inventory lista todos os itens disponíveis na história, não apenas aqueles atualmente possuídos pelo jogador. Você pode ajustar livremente as quantidades para testar crafting, 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 são acionados quando um item está presente.
  • Confirmar caminhos da história que dependem de objetos coletados.

4. Variables

4. Variables

A aba Variables 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 flags (verdadeiro/falso).
  • Alterar números diretamente.
  • Editar valores de texto.
  • Redefinir variáveis individuais.

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

5. Fluxo de Testes

O Debug Menu 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 a lógica de crafting funcionam corretamente.
  • Ramificações da história são desbloqueadas nas condições certas.
  • Transições de estado do jogador são consistentes.

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

6. Boas práticas

  • Use Logs para traçar o fluxo da história e confirmar a ordem dos eventos.
  • Use Variables para pular diretamente para ramificações específicas e testar rapidamente.
  • Use Inventory para testar crafting ou travas por item sem precisar rejogar cenas iniciais.
  • Redefina com frequência para verificar se sua história funciona corretamente a partir de um começo limpo.

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

Documentação