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
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
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
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.