← Guides

2026-10-18

Choose-your-own-adventure, visual novel or text adventure: which story are you writing?

Somewhere in your story, the reader gets to decide something. Maybe the knight takes the river road. Maybe the detective sends the pianist away. The moment you hand them that choice, you are writing interactive fiction, and the next question is which kind. The three big ones read nothing alike, and each asks something different of you.

In a text adventure, the reader types what they want to do. In a choose-your-own-adventure story, they pick from a few options. In a visual novel, they mostly read, with pictures and music, and choose now and then. Two questions tell you which one you are writing: what does the reader do, and how much of the story is drawn?

How you actHow it looksUsually written inOne you might know
Text adventure (parser IF)Type commands: TAKE LAMP, GO NORTHText only, sometimes a status lineInform 7, TADS 3, DialogZork
CYOA / choice-basedClick a link or pick from a listText, often styled; images optionalTwine, ink, ChoiceScript80 Days
Visual novelClick to advance, pick at choice pointsCharacters over backgrounds, music, voiceRen’Py, TyranoScript, NaninovelDoki Doki Literature Club
Gamebook (a CYOA with rules)Pick a numbered entry, sometimes roll dicePrint, or print-styledTwine, ChoiceScript, printThe Warlock of Firetop Mountain

Where the name “interactive fiction” comes from

Used broadly, it means any story where what the reader does changes what happens next. That is how itch.io uses it, how Steam tags it, and what most people mean when they type it into a search box.

The name is older than any software you can buy today. Robert Lafore coined it in 1979 for his own line of story programs. Infocom borrowed it in 1984, partly to sound classier than the games sitting next to theirs on the shelf. The label outlived the company.

There is a narrower meaning too, and it matters the day you go asking for help.

Text adventures: you type, the world answers

“It is pitch black. You are likely to be eaten by a grue.” If that line from Zork means something to you, you have played one.

The reader types instructions in something close to English, and a parser checks them against a simulated world: rooms, objects, what is inside what, what is locked. Will Crowther wrote the first one, Colossal Cave Adventure, in 1976, and Don Woods expanded it in 1977. It reached MIT that same year, where four students answered it with Zork. They founded Infocom in 1979 and sold Zork as their first product. Graphics killed the commercial market in the late 1980s, and the form carried on as a hobby, where it still lives.

For a writer, the world is the job. Besides the prose, you describe everything that exists and what happens when someone pokes it. And someone will try to eat the lamp. A parser game is judged on how gracefully it answers the commands its author never imagined, which is a strange standard to write against and most of the work.

The tools are Inform 7, whose code reads like English sentences, plus TADS 3 and Dialog. Games run in interpreters, including in a browser tab. The community meets at intfiction.org, catalogues its games on IFDB, and has competed at IFComp every autumn since 1995. Newcomers usually get handed Counterfeit Monkey (Emily Short, 2012) or Anchorhead (Michael Gentry, 1998).

It has the highest technical floor of the three and the smallest audience. It also has the best craft writing behind it, by a long way.

Choose-your-own-adventure: you pick, the story turns

If you grew up with the books, you remember the cheat: a finger wedged in the page you just left, in case the next one killed you.

Choose Your Own Adventure was a Bantam series, written mostly by Edward Packard and R. A. Montgomery, and the original run from 1979 to 1998 came to 184 books and more than 250 million copies. That is why one brand name still stands in for a whole form. Chooseco revived the series in 2005 and still publishes it, and the name is their trademark.

The digital versions are called choice-based, or hypertext. The reader clicks a link or picks from a short list, and the story moves on. The reader never types, and there is nothing to install. The bar is low and the writing comes first, which is why most new interactive stories are written this way.

The tools differ in how much code you have to look at. Twine, made by Chris Klimas in 2009, is a map of boxes and arrows that exports a single web page. ink is inkle’s plain-text scripting language, built for writers and used in the studio’s own games. ChoiceScript belongs to Choice of Games and comes with their publishing programme and their house style of stat-heavy interactive novels.

Two of them broke out of the niche. Depression Quest (2013) took Twine to an audience that had never heard of it. 80 Days (inkle, 2014) wrapped choice-based prose around a race around the world, and swept the XYZZY Awards that year.

Gamebooks are the branch with rules. Fighting Fantasy started in 1982 with The Warlock of Firetop Mountain, by Steve Jackson and Ian Livingstone, and handed readers dice, a SKILL score and a pencil. Digital ones are built with the same tools as the rest of this family.

Visual novels: long reads with pictures

A visual novel is the one you can recognise from across the room: characters standing over painted backgrounds, a text box along the bottom, music underneath, often a full voice cast.

The form comes out of Japanese games of the early 1990s. Chunsoft called them sound novels. The first was Otogirisou, on the Super Famicom, in March 1992. Its follow-up, Kamaitachi no Yoru, was a hit in 1994, and the form took off from there.

Readers arrive expecting certain comforts, and notice fast when one is missing: save anywhere, scroll back to reread, set the text speed, skip scenes they have already seen. Most visual novels open with a shared route that splits into separate character routes, with earlier choices deciding where you land and several endings waiting at the far end. An hour between decisions is normal and nobody complains. Try that in a choose-your-own-adventure book and the reader would assume they had skipped a page.

The names people know: Clannad, Fate/stay night, Steins;Gate, the Phoenix Wright games with their courtroom battles, and Doki Doki Literature Club, which Team Salvato released free in 2017: a horror game dressed up as a cute dating story.

Ren’Py is the engine almost everyone uses. Tom Rothamel released it in 2004. It is free and open source, and you script it in a language close to Python. The name is ren’ai, the Japanese word for romantic love, joined to Python, which tells you what it was first built for and how far it has wandered since. TyranoScript is the main free alternative, with TyranoBuilder as a paid drag-and-drop editor on top of it. Naninovel is a paid add-on for teams already working in Unity.

Ren’Py costs nothing, but the art does: characters with a face for every mood, backgrounds, the buttons and boxes around the text. Most solo authors pay an artist for it.

Why people argue about the words

The broad meaning at the top of this page is the common one. It is not universal, and knowing where it breaks will save you an awkward thread.

Among long-time fans, interactive fiction has meant parser games specifically. IFComp shows why: when it started in 1995 it had two divisions, one for Inform games and one for TADS, both parser systems, and that was the whole field. Twine changed the mix through the 2010s, and choice-based entries are now a large share of the competition.

Older guides use IF to mean parser, full stop. Emily Short has kept a running category on her blog for the parser-versus-choice question, which tells you how long it has been going. Choice of Games sidesteps it by calling its titles interactive novels. Visual novel is the one label nobody fights over, because you can see the difference.

Plenty of games sit across the lines on purpose. 80 Days is choice-based prose on top of a travel game. Sorcery! turned printed gamebooks into something you play with your thumbs. And plenty of visual novels have no choices at all, which makes them illustrated novels with a click to turn the page. They are still shelved as visual novels.

So use the broad term when you describe your story to readers, and match the local words when you ask a community for help.

Which one are you writing?

Ask what the reader should be doing. If the fun is poking at a world until it gives up its secrets, you are writing a text adventure, and you are building a simulation as well as a story. If the fun is decisions that cost something, it is choice-based. If it is a long, emotional read with a few forks in it, it is a visual novel.

Then ask what you can actually make. Choice-based stories are the ones a writer with no budget and no artist can finish alone. A visual novel needs pictures, or money for them. A text adventure needs you to enjoy the technical side, because you will spend real evenings there.

Most people arrive with a story and no fixed idea of its shape. If that is you, start choice-based. It is the shortest road to something a reader can open, and Twine is a fine place to start.


Nightwriter is a tool for writing branching, playable stories, and it isn’t released yet. It sits at the choice-based and visual-novel end of this map. Twine is excellent at what it does, and for a story told in text it is hard to beat. Nightwriter is for the step after that. It adds scenes and characters on a stage, written as plain text, with no code to learn. It is not a parser system, and the tools above are still the right answer for many writers today.