Uma escolha importa quando a história se lembra dela. Este projeto para iniciantes acompanha dois colaboradores adultos decidindo como abrir um estúdio, usando um pequeno grafo de passagens, uma decisão armazenada e dois finais. Ele precisa de pouquíssimos recursos gráficos. Sua primeira tarefa é fazer cada escolha levar ao resultado esperado e, depois, garantir que esse resultado seja mantido após salvar e recarregar.
O download contém o código-fonte Twee para SugarCube. Compile-o em HTML jogável com Tweego e um formato de história SugarCube instalado, ou recrie manualmente as passagens da história no Twine. O exemplo não foi executado aqui em um ambiente de execução do Twine, então conclua as etapas de teste abaixo antes de publicar.
Escolha o formato primeiro
Crie uma história no Twine, selecione SugarCube 2 como formato de história e registre a versão que você usa. Mantenha a documentação oficial à mão para consultar macros, variáveis e salvamentos. Os exemplos de Harlowe usam uma sintaxe diferente; copiá-los diretamente para SugarCube é uma maneira rápida de transformar uma cena simples em uma sessão de depuração.
No código-fonte baixado, as linhas que começam com :: introduzem passagens. StoryTitle e StoryData contêm informações de configuração. No editor do Twine, defina o título da história e o formato SugarCube, depois crie StoryInit e as seis passagens da história usando os nomes exatos. Copie o conteúdo de cada uma sem o cabeçalho :: e selecione Start como passagem inicial. Um arquivo .twee é um código-fonte editável; publique HTML para os jogadores.
Monte o grafo de passagens
O exemplo inicializa $sharedPlan com false. Start oferece duas respostas: SharedPlan define o valor como true, enquanto SeparatePlan o define como false. Ambas levam a Discussion, que verifica o valor e mostra o link para SharedEnding ou IndependentEnding. Esse é o grafo inteiro: uma decisão com uma consequência visível.
Dê às passagens nomes estáveis e fáceis de distinguir e verifique cada destino tanto no grafo visual quanto na versão compilada publicada. Um rótulo de link atraente não resolve um erro de digitação no nome do destino. Mantenha o nome interno da passagem separado do texto que você pode reescrever ou traduzir, para que uma mudança de redação não quebre a rota.
Mantenha as mudanças de estado previsíveis
Use uma variável nomeada para uma decisão específica. Aqui, $sharedPlan registra se o jogador escolheu um plano compartilhado; ela não precisa representar todos os sentimentos entre os personagens. Defina seu valor onde a escolha acontece e leia esse valor onde a consequência aparece. Manter essa relação clara facilita a expansão de uma história pequena.
Confira o que acontece quando um jogador revisita uma passagem. Se exibi-la adiciona um ponto, uma nova visita pode conceder outro ponto sem querer. Em projetos maiores, dê regras próprias aos eventos que devem acontecer uma única vez e decida se voltar pelo histórico da história deve desfazer seus efeitos. Teste também os recarregamentos, em vez de presumir que se comportam como uma primeira visita.
Crie uma página legível
Comece com a interface padrão do formato de história. Dê ao texto uma largura confortável para leitura, use uma fonte legível e deixe claro o foco nos links durante a navegação pelo teclado. Confira parágrafos e escolhas em uma tela estreita. Uma camada decorativa ajuda pouco quando o jogador não consegue encontrar a próxima linha; adicione fundos elaborados só depois que a leitura estiver fluida.
Mantenha as configurações e os controles de reinício e salvamento fáceis de encontrar. Use mais do que cor para identificar links disponíveis ou estados importantes, para que a página continue compreensível quando uma indicação de cor passar despercebida. Se adicionar áudio ou movimento, ofereça controles e comece de forma discreta. Deixe os jogadores escolherem quando a trilha sonora ou a animação entra na cena.
Publique e teste a persistência dos dados
Publique pelo Twine ou compile o código-fonte em HTML com o formato SugarCube selecionado, depois disponibilize esse arquivo pela hospedagem que pretende usar. Teste-o no navegador e na origem do site que os jogadores vão usar. O armazenamento do navegador está vinculado ao seu contexto, então um salvamento local bem-sucedido não basta para determinar como a versão hospedada se comporta.
Salve antes da decisão e novamente depois dela. Feche a página, abra-a de novo e carregue cada salvamento, verificando se a escolha lembrada e o final disponível estão corretos. Repita o teste em um novo perfil do navegador, criando novos salvamentos nele. Verifique separadamente a navegação privada, o armazenamento apagado e a disponibilização incorporada em outra página. Descreva os limites que encontrar; as configurações do navegador e o comportamento da hospedagem podem impedir que os salvamentos persistam.
Prepare um processo de atualização
Mantenha o código-fonte editável sob controle de versão e arquive cada versão HTML publicada. Registre a versão do SugarCube e as mudanças nas passagens e guarde arquivos de salvamento representativos para comparar uma atualização com a versão compilada anterior. Decida se as atualizações vão dar suporte aos salvamentos existentes. Se os jogadores precisarem recomeçar, explique essa exigência antes de carregarem a nova versão.
Jogue cada final começando do zero e verifique todos os links com o teclado e, quando pertinente, com controles por toque. Use a matriz de testes de rotas para registrar os resultados esperados e os reais. Você pode seguir em frente quando a história estiver clara para ler, seu estado se comportar de forma previsível e você conseguir repetir o processo de publicação. Consulte o guia de rotas e estados antes de montar uma grande rede de ramificações.
Decisões-chave
- Selecione SugarCube 2 antes de escrever macros SugarCube.
- Guarde o código-fonte Twee; publique HTML jogável.
- Teste visitas repetidas, salvamentos e recarregamentos na hospedagem prevista.
- Mantenha os nomes das passagens estáveis e arquive as versões publicadas.
Arquivos do guia
Exemplo Twee para SugarCube ↓Matriz de testes de rotas ↓Comunidades externas dedicadas a modelos e sites externos de publicação podem conter material explícito. Os links para as fontes abrem em uma nova aba; este guia não carrega suas prévias.
Fontes e leituras adicionais +
Última verificação 5 de outubro de 2026.