Ações

Ações definem o que acontece quando um evento, um gatilho ou um temporizador é acionado. Elas são a etapa final na cadeia lógica do Talescape, depois que um gatilho dispara e as condições são atendidas.

As ações também podem ser usadas diretamente em linhas de diálogo, permitindo que pequenas atualizações de lógica ocorram durante conversas sem precisar de eventos separados.

Uma ação executa uma única operação em resposta a um evento ou diálogo. As ações podem modificar o estado da história, afetar o inventário do jogador, coletar entrada do jogador ou controlar elementos de apresentação como cenas, som, interações ou texto.

Você pode anexar várias ações a um evento e escolher se elas são executadas todas de uma vez ou sequencialmente.

Por padrão, todas as ações anexadas a um evento são executadas simultaneamente. Se a opção Sequencial estiver ativada no evento, as ações são executadas uma após a outra na ordem em que aparecem.

A execução sequencial é útil para:

• Cutscenes ou narração temporizada.
• Lógica dependente (p.ex., definir uma variável e depois mudar a cena).

As ações cobrem uma ampla variedade de funções de lógica e apresentação. As mais comuns incluem:

• Variáveis: Definir, aumentar, diminuir, alternar, anexar, randomizar ou calcular valores de variáveis.
• Entrada: Pedir ao jogador texto livre ou um valor selecionado e armazenar o resultado em uma variável.
• Inventário & Itens: Dar um item, remover um item ou fabricar um item a partir de uma receita.
• Conquistas: Desbloquear ou verificar uma conquista.
• Cenas: Mudar cena, ocultar ou mostrar elementos, reproduzir ambiente e efeitos sonoros.
• Diálogo: Iniciar ou encerrar um diálogo.
• Temporizadores: Iniciar, parar, pausar ou reiniciar um temporizador.
• Interações: Impedir temporariamente ou restaurar a interação do jogador durante cutscenes, sequências temporizadas ou transições.
• Sistema: Salvar progresso, tocar som ou exibir mensagem ao jogador.

Todas as ações disponíveis são sincronizadas automaticamente com o editor.

Você pode encadear múltiplas ações para criar resultados complexos, por exemplo:

1. Dar ao jogador uma lanterna.
2. Definir uma flag marcando a cena como “explorada.”
3. Mover para a próxima área.

As ações são executadas instantaneamente, a menos que o evento esteja marcado como Sequencial, caso em que elas aguardam a conclusão da ação anterior.

Além dos eventos, você pode anexar ações diretamente a linhas de diálogo. Elas são executadas imediatamente quando aquela linha específica é exibida, o que é útil para pequenas atualizações de estado ou lógica em linha.

Exemplos:

• Conceder uma conquista quando o jogador fala uma linha específica.
• Alterar uma variável após uma conversa-chave.
• Armazenar um nome fornecido pelo jogador ou um valor selecionado para uso posterior.
• Iniciar um temporizador quando o diálogo atingir um determinado ponto.

Isso permite que Bards implementem lógica da história diretamente no fluxo de diálogo sem criar eventos separados, mantendo interações curtas compactas e fáceis de gerenciar.

Você pode verificar se as ações se comportam como esperado usando:

• Prévia da História – para testar em tempo real.
• Menu de Depuração – para confirmar mudanças em variáveis e inventário.
• Aba de Logs – para rastrear quando cada ação é executada.

Se uma ação não for acionada como esperado, verifique se:

• As condições do evento são atendidas.
• O evento está ativo no escopo atual.
• A opção Sequencial corresponde ao comportamento desejado.

• Use ações de diálogo para pequenos efeitos em linha.
• Use eventos para lógica mais ampla ou reutilizável.
• Mantenha as ações focadas: um evento por momento lógico.
• Use ações sequenciais para ritmo e ações simultâneas para maior responsividade.
• Teste cadeias complexas de ações individualmente antes de combiná-las.

As ações são onde a lógica da história encontra a narrativa, seja acionada pela escolha do jogador, um temporizador ou uma linha de diálogo. Elas tornam sua história dinâmica, responsiva e viva.