How to Use Twine

How To Use Twine

What is Twine?

Twine is an open-source tool for telling interactive, nonlinear stories. You don't need to use code to create a simple story with Twine, but it allows you to extend your stories with variables, CSS, and JavaScript once you become more accustomed to the program. It is often used to create adventure games such as "choose your own adventures", and allows the player to select through different choices in order to finish the narrative.

The Basics

First, download Twine here. You can either use the program online through their website, or download it to be able to use it offline.

Once you open Twine, you will see a green +Story button to the right of your screen. Create a name (you can change it later) and start creating your story.

You can test and view your Twine by clicking on either the "Test" or "Play" button to view it in another tab.

Here is a quick video to get you started.

Basic Twine Commands

Commands What they do
[[Hyperlinked Words]] Putting text within double brackets allows it to become a clickable passage.
[[Hyperlinked Words|Passage Name]] The pipe keyboard character ( | ) can be used to give a name for the target passage.
(link:"Words you want linked")[New words that appear and will replace the linked text] This tool keeps the player in the same passage, and simply extends the paragraph to include the new text while the previous text remains on the screen.
(display:"Name of Passage") Add this line to any passage where you want to repeat the text of another passage.

Getting Started

This will be the first thing you see once you open up twine and start creating your first narrative. Each white box is called a "passage". After you double click on the passage to edit, it will expand into a text box that you can work on. As an example, type the following text into the box:

You are facing two doors. One is a beautiful shade of blue that looks as if it is made out of water. The other is a dark and dingy door with a spider web clinging to the edge.

Just like in any other story, you as the author will get to decide what happens next. To provide options in Twine, you need to place square brackets around the words you want clickable within the game. You can also add a vertical bar to provide a name for the target passage to the right of that bar, as shown in the chart above.

Then you start a new paragraph and write the following directly below the text you already have in the box:

Do you want to open the [[the blue door?|Blue Door]]
Or do you want to open [[the black door?|Black Door]]



Once you click on the X in the upper-right corner of the box, you will see two new passages on the screen. By double-clicking on those, you can create what happens to the player once they select one of the doors. To try it out, exit out of the text box and hit the play button on the bottom right of your screen.

Good job! Now you know how to create a basic story in Twine.