---
title: "Crie uma história para o navegador com Twine e SugarCube"
description: "Crie uma pequena história em SugarCube com uma escolha memorizada, dois finais e um processo prático para publicar HTML e testar salvamentos."
language: pt-BR
canonical: https://bestadultgames.io/pt-BR/developers/guides/first-twine-game
---

[Visão geral](https://bestadultgames.io/pt-BR/developers.md) [Comece aqui](https://bestadultgames.io/pt-BR/developers/start.md) [Ferramentas](https://bestadultgames.io/pt-BR/developers/tools.md) [Modelos de IA](https://bestadultgames.io/pt-BR/developers/models.md) [Guias](https://bestadultgames.io/pt-BR/developers/guides.md) [Civitai & LoRA](https://bestadultgames.io/pt-BR/developers/lora.md) [Publicação](https://bestadultgames.io/pt-BR/developers/publishing.md) [Modelos de documentos](https://bestadultgames.io/pt-BR/developers/templates.md)

[Desenvolvedores](https://bestadultgames.io/pt-BR/developers.md) / [Guias](https://bestadultgames.io/pt-BR/developers/guides.md) / Motores

Iniciante · S prioridade de leitura

# Crie uma história para o navegador com Twine e SugarCube

Crie uma pequena história em SugarCube com uma escolha memorizada, dois finais e um processo prático para publicar HTML e testar salvamentos.

Best Adult Games · 4 min de leitura · Fontes verificadas em 5 de outubro de 2026 · Com base na documentação publicada

![Diagrama de fluxo do design do jogo ao motor e à versão jogável, com o design do jogo em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-intro-1.svg)

*Uma decisão lembrada dá a uma história pequena uma consequência que os jogadores podem testar. Best Adult Games · diagrama original*

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

![Diagrama de fluxo das necessidades da história ao formato de história e à versão de teste, com o formato de história em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-1-1.svg)

*Selecione SugarCube antes de copiar as macros do exemplo. Best Adult Games · diagrama original*

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

![Diagrama de fluxo da passagem à escolha e à próxima passagem, com a próxima passagem em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-2-1.svg)

*Verifique o nome do destino com o mesmo cuidado que o rótulo visível da escolha. Best Adult Games · diagrama original*

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

![Diagrama de fluxo do estado à transição e à condição, com o estado em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-3-1.svg)

*$sharedPlan leva a decisão da resposta até o final. Best Adult Games · diagrama original*

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

![Diagrama de fluxo do texto ao layout e à entrada, com o layout em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-4-1.svg)

*Confira a fluidez da leitura e o foco nos links antes de adicionar fundos decorativos. Best Adult Games · diagrama original*

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

![Diagrama de fluxo da publicação ao salvamento e ao recarregamento, com o recarregamento em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-5-1.svg)

*Um teste de salvamento precisa tanto da página hospedada quanto da versão compilada local. Best Adult Games · diagrama original*

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

![Diagrama de fluxo da versão à migração e ao teste de atualização, com a versão em destaque.](https://bestadultgames.io/images/localized/pt-BR/developer-guides/first-twine-game-section-6-1.svg)

*Versões compiladas arquivadas e salvamentos representativos permitem verificar o que uma atualização muda. Best Adult Games · diagrama original*

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](https://bestadultgames.io/developers/templates/studio-sample.twee) [Matriz de testes de rotas](https://bestadultgames.io/developers/templates/test-matrix.csv)

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

- [Twine](https://twinery.org/)
- [Twine Cookbook](https://twinery.org/cookbook/)
- [Código-fonte e documentação oficiais do SugarCube](https://github.com/tmedwards/sugarcube-2)
- [Compilador Tweego](https://www.motoslave.net/tweego/)

Última verificação 5 de outubro de 2026.

## Neste guia

1. [Escolha o formato primeiro](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-1)
2. [Monte o grafo de passagens](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-2)
3. [Mantenha as mudanças de estado previsíveis](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-3)
4. [Crie uma página legível](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-4)
5. [Publique e teste a persistência dos dados](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-5)
6. [Prepare um processo de atualização](https://bestadultgames.io/pt-BR/developers/guides/first-twine-game#section-6)

## Ferramentas e modelos relacionados

- [Twine](https://bestadultgames.io/pt-BR/developers/tools?q=Twine)

[Templates de produção](https://bestadultgames.io/pt-BR/developers/templates.md)

## Guias relacionados

Motores · Iniciante · 3 min de leitura

### [Escolha um motor de acordo com o jogo que você está criando](https://bestadultgames.io/pt-BR/developers/guides/engine-comparison.md)

Escolha entre Ren'Py, Twine, Godot, RPG Maker MZ, Unity e Unreal testando as tarefas de que seu jogo realmente precisa.

Leia o guia → S prioridade de leitura

Motores · Iniciante · 4 min de leitura

### [Crie sua primeira história em Ren'Py com dois finais](https://bestadultgames.io/pt-BR/developers/guides/first-renpy-game.md)

Aprenda a trabalhar com diálogos, escolhas, estado, salvamentos e verificações antes do lançamento com uma pequena história em Ren'Py sem conteúdo explícito.

Leia o guia → S prioridade de leitura

Motores · Avançado · 3 min de leitura

### [Definir o escopo e avaliar um jogo 3D em tempo real](https://bestadultgames.io/pt-BR/developers/guides/realtime-3d.md)

Compare Godot, Unity e Unreal com uma cena jogável, um ciclo de interação e um orçamento de desempenho para seu dispositivo-alvo.

Leia o guia → B prioridade de leitura