Configurando sua História » Capítulos & Cenas
April 1, 2026

Capítulos & Cenas

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.

As histórias no Talescape são organizadas em capítulos e cenas. Juntos, eles definem a estrutura do seu projeto e como os jogadores progridem nele.

1. Capítulos

Um capítulo é um contêiner que agrupa cenas relacionadas. Ele ajuda a organizar sua história em seções lógicas como Prólogo, A Floresta ou Retorno para Casa.

Capítulos também podem definir eventos que disparam quando o capítulo começa, termina ou quando condições específicas são atendidas. Eles costumam ser usados para configurar ambientação, inicializar variáveis ou gerenciar lógica de fundo compartilhada por todas as cenas dentro daquele capítulo.

Usos típicos:

  • Estruturar histórias longas em atos ou locais principais
  • Configurar ambientação de fundo, variáveis ou música
  • Controlar ritmo e tom entre seções
  • Manter enredos complexos organizados

Os capítulos em si não exibem conteúdo; eles controlam e coordenam as cenas dentro deles.

Configurações do Capítulo

Capítulos sempre têm um título e uma descrição opcional. Você pode decidir se quer mostrar uma tela de título quando um novo capítulo começar. Ou exiba o título do capítulo ou uma tela de capítulo dedicada criada por você. Use "Mostrar Tela de Título" para ativar esse recurso.

Capítulos também têm alguns recursos de conveniência embutidos. No momento, você pode limpar o inventário do Dreamer antes de ele ou ela entrar na próxima cena. Mais configurações serão adicionadas aqui quando disponíveis.

Capítulos Demo Gratuitos

O primeiro capítulo de uma história paga pode opcionalmente ser marcado como uma demo gratuita. Quando ativado, Dreamers podem jogar esse capítulo sem comprar a história completa. Isso permite que Bards dêem aos jogadores uma prévia enquanto mantém os capítulos posteriores atrás do paywall.

2. Cenas

Uma cena é a menor unidade jogável em uma história. As cenas contêm o conteúdo com o qual o jogador interage: diálogo, visuais, gatilhos e lógica. É onde narrativa, mídia e interação se unem.

Talescape suporta dois tipos de cena:

Cenas Normais

Usadas para o fluxo principal da história. Elas ocupam a tela inteira e conectam-se a outras cenas ou capítulos. Cenas normais definem a espinha dorsal da estrutura da história.

Exemplos:

  • “Chegada ao Porto”
  • “A Antiga Biblioteca”
  • “Fuga pela Floresta”

Cenas de Detalhe

Cenas de detalhe são sobreposições pequenas e autocontidas que abrem sobre uma cena normal. Podem ser fechadas pelo jogador a qualquer momento e não pausam a cena principal. São ideais para interações curtas e contextuais ou detalhes opcionais.

Exemplos:

  • Inspecionar um objeto (por exemplo, abrir um baú ou ler um bilhete)
  • Ver um breve flashback ou memória
  • Resolver um pequeno quebra-cabeça ou interação de item

Cenas de detalhe devem ser abertas através de uma ação Abrir Cena de Detalhe. Elas não podem ser alcançadas pela navegação normal. Também não podem atuar como cenas iniciais de um capítulo.

Configurações da Cena

Cenas têm um título, um tipo (conforme explicado acima) e várias outras configurações. Cenas de detalhe têm dimensões. Essas normalmente serão definidas automaticamente para as dimensões da imagem de fundo. Como o Talescape tem como alvo a resolução de 1920 x 1080, elas não podem exceder esses valores.

Apenas cenas normais podem ter Música e/ou Ambiente. Música é (como você pode imaginar) a trilha sonora de fundo da cena. Ela começará a tocar assim que o Dreamer entrar na cena. Se cenas diferentes compartilharem a mesma música, a música continuará tocando sem interrupção entre transições de cena. O mesmo vale para o ambiente. Ambiente é usado principalmente para uma paisagem sonora de fundo: ondas quebrando na costa, conversas distantes num café, você escolhe.

3. Composição da Cena

Cada cena é composta por elementos, como texto, imagens e gatilhos. Elementos definem o que acontece visualmente e de forma interativa dentro daquela cena.

Elementos típicos incluem:

  • Diálogo e narração
  • Cenários e sobreposições
  • Gatilhos de som ou música
  • Objetos interativos ou links inline

Os detalhes de como adicionar e configurar elementos de cena estão explicados no artigo do Editor de Cena.

4. Navegação de Cenas

Cenas e capítulos são conectados usando ações que determinam como o jogador se move pela história.

Métodos comuns de navegação:

  • Ir para Cena – Ir diretamente para outra cena.
  • Abrir Cena de Detalhe – Abrir uma sobreposição de detalhe e retornar quando fechada.
  • Sucesso de Capítulo – Marcar o capítulo atual como concluído e acionar a transição.

A transição de capítulo só ocorre quando uma ação Sucesso de Capítulo é acionada. Se o capítulo não for o último, o Talescape carrega o próximo capítulo e executa seus eventos de início. Se for o capítulo final, a história termina e ocorre a rolagem de créditos.

Cenas inacessíveis ou não utilizadas são detectadas automaticamente pelo Sistema de Verificações.

5. Nomeação & Organização

Use nomes curtos e descritivos tanto para capítulos quanto para cenas. Evite duplicatas e mantenha a nomenclatura consistente em projetos grandes. Prefixos como 1_Intro, 2_Forest ou 2_Forest_Inline_Chest ajudam a manter a clareza no editor.

Mantenha as cenas modulares: unidades menores e focadas são mais fáceis de depurar e reutilizar.

6. Testando a Estrutura

Use a Prévia da História para verificar transições de cena, interações de detalhe e o fluxo de capítulos. Acionar uma ação Sucesso de Capítulo durante os testes simulará a conclusão do capítulo e fará a história avançar. Se for o capítulo final, a prévia terminará.

O Sistema de Verificações marca automaticamente quaisquer cenas inacessíveis ou ausentes.

Com seus capítulos e cenas configurados, você agora pode passar para configurar metadados, avisos de conteúdo e permissões de colaboradores.

Próximo: Editor de Cena

Documentação