Twee

Twee is a command-line tool for creating interactive fiction, also known as text adventure games. It uses the Twee markup language, which is based on HTML and is easy to learn. Twee is written in Ruby, but you don't need to know Ruby to use it.

Installation

To install Twee, you need to have Ruby installed on your system. Once you have that, you can install Twee using the following command:

gem install twee

Creating a story

To create a story with Twee, you first need to create a new file with a .tw extension. This file will contain your story in Twee markup language. Here's an example of a simple story:

:: StoryTitle
My First Story

:: Start
You wake up in a dark room.

[[Explore->Room1]]

:: Room1
You see a door on the left side of the room and a window on the right.

[[Go through the door->Room2]]
[[Look out the window->Window1]]

:: Room2
You entered the next room.

[[Back to the first room->Room1]]

:: Window1
You see a beautiful landscape.

[[Back to the first room->Room1]]

In this story, the player starts in a dark room and has two options: explore or quit. If the player chooses to explore, they are taken to another room where they have two more options, and so on.

Compiling your story

Once you have created your story in Twee markup language, you need to compile it into a format that can be played by an interpreter. Twee supports several output formats, including HTML, Twine, and SugarCube.

To compile your story into HTML, use the following command:

twee -o index.html story.tw

This will create an index.html file that you can open in a web browser to play your story.

Conclusion

Twee is a great tool for creating interactive fiction. It's easy to learn, and it supports several output formats. If you're a fan of text adventure games, give Twee a try!