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