Variáveis

Variáveis armazenam informações sobre o que aconteceu na sua história e sobre o que o jogador fez. Elas permitem que o jogo lembre escolhas, acompanhe progresso, controle como o mundo reage e, opcionalmente, mostre estatísticas importantes para o jogador.

Variáveis são a base da lógica no Talescape. São comumente usadas para controlar opções de diálogo, acionar eventos, desbloquear itens ou determinar quais cenas ficam disponíveis.

Variáveis podem pertencer à história inteira, a um capítulo ou a uma única cena. Isso mantém o estado local próximo do lugar onde é usado, ao mesmo tempo que permite que valores importantes fiquem disponíveis em todo lugar.

Variáveis são criadas no Painel de Variáveis. Cada variável inclui as seguintes configurações:

• Nome: Um rótulo descritivo usado para identificar a variável no editor.
• Tipo: Determina que tipo de valor a variável armazena.
• Escopo: Determina se a variável pertence à história, a um capítulo ou a uma cena.
• Valor Inicial: O valor atribuído quando a história começa.
• Configurações de Estatística (opcional): Determina se a variável deve ser mostrada ao jogador como uma estatística visível.

O valor inicial é opcional. Se nenhum valor for fornecido, a variável começa vazia ou com seu valor padrão.

O escopo de uma variável determina a que ela pertence e onde ela normalmente deve ser usada.

• Story: Use isto para valores que importam em toda a história, como vida, sanidade, afeto ou uma escolha importante que afeta capítulos posteriores.
• Chapter: Use isto para valores que só importam dentro de um capítulo, como o número de documentos coletados naquele capítulo.
• Scene: Use isto para estado local dentro de uma cena, como se uma TV foi ligada.

Variáveis de story mantêm o comportamento anterior. Variáveis de capítulo e de cena ajudam a manter projetos grandes mais fáceis de ler, porque estados temporários não precisam mais ficar junto ao estado central da história.

Variáveis de escolha armazenam um simples valor verdadeiro ou falso. Elas são usadas para decisões de sim ou não e são o tipo de variável mais comum.

Usos típicos incluem:

• Acompanhar se o jogador realizou uma ação específica.
• Registrar decisões tomadas durante um diálogo.
• Desbloquear eventos ou opções de diálogo.

Exemplos de uso:

• O jogador abriu o baú?
• O jogador ajudou o pescador?
• A entrada da caverna está guardada?

Variáveis de escolha podem ser alternadas entre verdadeiro e falso por meio de ações ou eventos.

Variáveis numéricas armazenam valores numéricos. Elas são úteis quando você precisa rastrear contagens, pontuações ou valores de progressão.

Usos típicos incluem:

• Rastrear recursos coletados
• Contar quantas vezes algo aconteceu
• Gerenciar moedas ou pontos

Exemplos de uso:

• Quantas chaves o jogador tem?
• Quanto dinheiro foi coletado?
• Quantas pistas foram descobertas?

Variáveis numéricas podem ser aumentadas, diminuídas ou definidas para um valor específico durante o jogo.

Variáveis de texto armazenam trechos curtos de texto. Elas são úteis quando você precisa lembrar nomes, códigos ou seleções feitas pelo jogador.

Usos típicos incluem:

• Armazenar o nome escolhido pelo jogador
• Registrar qual opção foi selecionada
• Salvar códigos ou identificadores

Exemplos de uso:

• Nome do jogador
• Facção selecionada
• Código da porta inserido

Variáveis de texto podem ser atualizadas sempre que for preciso armazenar um novo valor.

Variáveis calculadas derivam seu valor de uma expressão em vez de manter um valor fixo. A expressão pode usar números simples ou placeholders para outras variáveis.

Operadores suportados são *, +, /, %, - e parênteses.

Variáveis calculadas são úteis para valores como dano após a armadura, uma pontuação formada por vários contadores ou um valor de progresso baseado em itens coletados. Elas mantêm a lógica derivada em um só lugar, em vez de exigir várias atualizações separadas de variáveis.

Variáveis podem ficar ocultas como lógica interna da história ou podem ser marcadas como estatísticas quando o jogador deve entender o valor atual durante o jogo.

Estatísticas são úteis para valores como:

• vida ou resistência
• sanidade, suspeita ou perigo
• valores de relacionamento
• recursos coletados
• progresso do capítulo ou do quebra-cabeça

Uma estatística pode ser exibida em diferentes formatos:

• Texto: Mostra o valor diretamente. Útil para nomes, rótulos, contadores ou valores onde a escrita exata importa.
• Barra: Mostra o progresso como uma barra preenchida. Útil para vida, resistência, sanidade ou outros valores com um mínimo e máximo claros.
• Segmentos: Mostra o progresso como blocos separados. Útil para corações, cargas, progresso de pistas ou recursos limitados.

Marque variáveis como estatísticas apenas quando o jogador se beneficia de vê-las. Variáveis que só controlam condições ocultas, ramificações ou estado interno da história podem permanecer variáveis normais.

Variáveis podem ser inseridas em campos de texto suportados como espaços reservados. Quando um campo de texto suporta placeholders, o editor mostra um seletor para que você não precise lembrar os nomes exatos das variáveis.

Isso é útil para nomes de jogador, contagens de itens coletados, facções selecionadas, respostas lembradas ou qualquer outro valor que deva aparecer no texto.

O mesmo seletor também está disponível onde quer que condições e ações precisem de um valor de variável. Isso mantém o reuso de variáveis consistente entre escrita e lógica.

Variáveis são usadas por todo o editor para controlar como a história se comporta.

Elas podem ser usadas para:

• Mostrar ou esconder opções de diálogo
• Ativar gatilhos e eventos
• Controlar caminhos de história ramificados
• Desbloquear cenas, itens ou interações
• Preencher campos de texto suportados com valores armazenados
• Calcular valores a partir de outras variáveis

Sempre que uma variável muda, o novo valor é armazenado imediatamente e permanece ativo pelo resto da jogada.

Durante os testes, você pode abrir o Menu de Depuração para inspecionar e modificar variáveis em tempo real.

Isso permite que você:

• veja todas as variáveis atualmente usadas na história
• altere valores para testar caminhos alternativos
• reinicie variáveis para seus valores iniciais
• verifique variáveis com escopo na cena ou capítulo relevante

Isso facilita testar lógica de ramificação complexa sem rejogar toda a história.

• Use Variáveis de escolha para decisões simples de sim ou não.
• Use Variáveis numéricas para contadores, recursos ou acompanhamento de progresso.
• Use Variáveis de texto somente quando precisar armazenar valores de texto.
• Use Variáveis calculadas para valores derivados de outras variáveis.
• Mantenha estado temporário em variáveis de cena ou capítulo quando não for relevante globalmente.
• Marque variáveis como estatísticas apenas quando o jogador deve ver esse valor durante o jogo.
• Mantenha nomes de variáveis descritivos para que sejam fáceis de entender mais tarde.
• Remova variáveis não usadas para manter seu projeto organizado.

Variáveis permitem que o Talescape lembre o que aconteceu e reaja de acordo. Elas formam a espinha dorsal de condições, ações e todos os caminhos ramificados da sua história.