How to program a text adventure in C(helderman.github.io)
208 points by nivethan 15 hours ago | 13 comments
dmbaggett 6 hours ago
Many years ago (circa 1993) I ported the original Colossal Cave adventure by Crowther and Woods to TADS, a language created by Mike Roberts specifically for authoring text adventures. (Colossal Cave just came up recently here.)

https://ifdb.org/viewgame?id=c896g2rtsope497w

Graham Nelson ported my port to his Inform language, and Inform is probably your best choice if what you actually want to do is write a (plain text) adventure game.

If you want to learn C programming, writing a text adventure in C would be a fun learning project! But aside from pedagogy there’s no real reason to write a text adventure in anything other than Inform, TADS, etc. Not only is it much easier to use one of these purpose-built languages, with Inform you get multi-platform compatibility going back to the 8-bit era for free!

Personally if I had any free time, I’d be more interested in looking at how to use a frontier LLM like llama as an integral part of a text adventure. There was something like this using GPT-2 circulating on here a while back, but it was pretty rough.

However, it’s clear that if you figured out how to precisely control the LLM so it didn’t produce crazy stuff, you could realize the dream of truly realistic NPCs in these games. Text adventures would seem to be a perfect laboratory for experimenting with this.

cut3 3 hours ago
cave is the first game i remember feeling immersed in. it was so good. its awesome you ported it!

Im playing with an LLM to remake drug wars. i pretty quickly changed it to more of a spiritual successor because i wanted to add more features and then had a hard time with them and the drug mechanic so i switched to financial trading and that made more sense. the i changed it to crypto coins in a dystopian future instead of stocks cuz the ascii art needed some lore to help flavor it now that gritty drugs were out

anthk 55 minutes ago
Just get dopewars
pdfernhout 3 hours ago
I wrote StoryHarp for creating speech-interactive choose-your-own text adventures back around 1998 (in Delphi for Windows desktop), and ported it to the web about seven years ago (with some limitations) using TypeScript and Tachyons: https://storyharp.com/v3.0

Realistically, StoryHarp might be most fun to use as an authoring tools for kids making short idiosyncratic adventures to share with friends. StoryHarp could help people practice creative writing and learn just a bit of logic to set up puzzles (without getting bogged down in more computing complexity like writing C code or even just the conceptual demands of TADS or Inform, as amazing as those tools are).

I recently added a option (inspired by "flems.io") where you can create a StoryHarp link that includes the entire world definition in the hash. For example, here is a URL for a game that just says "You are visiting the Hacker News website" when you click "look": https://storyharp.com/v3.0/#world=N4Ig7g9gTgNgJgMQJYwKYDkCGB...

Otherwise the game stores data only in the browser (not the server) which can be exported or imported as files.

While I can see how LLMs might make for more realistic interactions with text adventures, writing text adventures is its own sort of puzzle (like coding programs manually), and I am not sure adding LLMs will really make creating such adventures a much more joyful experience. But maybe it could. I agree in general though that text adventures make a great playground for experimenting with new ideas (as with StoryHarp as an experiment in bringing browser ideas from Smalltalk into interactive fiction design).

P.S. I just expanded that Hacker News story with a couple more rules so you can have more of an experience: https://storyharp.com/v3.0/#world=N4Ig7g9gTgNgJgMQJYwKYDkCGB...

Anyway, that is the sort of idiosyncratic short experiential interactive fiction I am talking about. Just spend five or ten minutes and make something that captures an emotion or a theme or a concern or an moral conundrum or whatever.

anthk 5 hours ago
>8 bit

with Puny Inform6 or limiting Inform6, yes. If not, it's suicidal, even for v3 games. But, from Amiga and Atari machines, most v5 and v8 games if not all will run great.

jhbadger 4 hours ago
You would probably do better on 8-bits by using ZIL which is actually feasible these days thanks to ZILF (and the leaked ZIL source code of the original Infocom games to look at).
anthk 55 minutes ago
Puny Inform it's good enough.
serhack_ 12 hours ago
I was wondering: does anybody know if there are any good resources for writing a good text adventure? Any nice tips and tricks? Mainly related to the content. I guess it overlaps with "writing a good novel", but I bet there're some specific advices that can be applied to the text adventure.

I wanted to write my text adventure, but I'd offer reader to have multiple options, especially for those who are not really practical with english (includes myself ^-^).

eigenhombre 9 hours ago
Aaron Reed's 50 Years of Text Games[1][2] is a fantastic journey into the history and the possibilities of text-based games. I got the physical book and was surprised to find it as engaging as a novel. Each chapter takes one year between 1971 and 2020 and picks a game from that year to discuss in depth. While it might not help with the writing per se, you might good ideas there (several of the games discussed are in the "Adventure" lineage).

[1] https://if50.substack.com/archive?sort=new

[2] https://if50.textories.com/

kaiokendev 2 hours ago
I can second this. I own the physical as well, has many pages going over the code used in the games being covered and why they were written that way.
laurieg 11 hours ago
For the technical side of things, use ink script. There's an editor, plugins and it's a mature project.

For the creative side I would recommend trying out all kinds of things. Should your player be able to get stuck/into a dead end? Will players play once or many times. Can you "win" your game or is it more of a narrative? How do you want the player to feel!

For some more specific ideas, think about how your game branches. Branching and decisions in games are far trickier than they might appear. Too subtle and the player misses the choice entirely. Too in your face and they become boring ("kill the baby" vs "save the baby", gee I wonder which one takes me down the evil path)

Also, merely asking a question or giving a choice can influence the player. If you ask "who is the killer?" and give a list of suspects, one of them must have done it, even if the player never considered it. The question also assumes the player knows there was a murder and gives that away if they hadn't worked it out yet.

4 hours ago
dejobaan 8 hours ago
Yeah, I like things like Ink a great deal. It's really easy to overcomplicate narrative design if you're not careful, but Ink (and so forth) do a good job of keeping things simple and staying out of your way.
adelineJoOs 1 hour ago
Slightly adjacent, I like these two blog articles that show ways to think about non-linear dialogues:

https://philipphagenlocher.de/post/video-game-dialogues-and-...

(introduces an interesting and useful way to think about dialogues, in my opinion)

https://philipphagenlocher.de/post/data-aware-dialogues-for-...

(further expands on the ideas of the first blog post, automatically ensuring that some properties that might be desirable)

bloat 11 hours ago
The Inform Designer's Manual is mostly about Inform 6 programming, but has a lot of material on game design.

https://www.inform-fiction.org/manual/DM4.pdf

Crimes Against Mimesis was a famous tract in its day. I don't know how things have moved on since then.

https://www.rickandviv.net/index.php/2004/08/18/crimes-again...

mseepgood 8 hours ago
Ron Gilbert's 1989 "Why Adventure Games Suck And What We Can Do About It" https://grumpygamer.com/why_adventure_games_suck/
anthk 5 hours ago
Text adventures are not graphical adventures. Text games don't have the linearity and constraints of a graphical one.

Compare Anchorhead, Devours, Spider and Web... with most point and click games.

sltkr 3 hours ago
Gilbert's essay wasn't limited to graphical adventure games.
11 hours ago
rednab 11 hours ago
As some of the other comments allude to, the term of art for text adventure is "interactive fiction".

The Interactive Fiction Wiki is a nice place to start:

https://www.ifwiki.org/Main_Page

And if you search for something like "interactive fiction tips" you'll find tons of resources.

glimshe 10 hours ago
You can find many books on text adventures from the 1980s in the Internet Archive. The Inform manual has also quite a few tips and tricks.
MrVandemar 11 hours ago
stevekemp 2 hours ago
I did once write a text-based adventure game in C, however I only did that to work out some of hte "plot" and the layout/objects I was going to work with.

My actual aim was to write a simple text-adventure in Z80 assembly, which could run upon a CP/M system. I did achieve that, and later ported the game to the ZX Spectrum.

A few years after that I used one of the inform-compilers to recode a couple of the puzzles in the Z-machine, which would also have allowed me to run the game on a CP/M system, but to be honest by that point I'd lost interest and I never ported the whole of the game's text, and the two different endings etc.

That said my toy adventure was popular when submitted here, back in the day:

https://news.ycombinator.com/item?id=26946130

nine_k 3 hours ago
Didn't read the article, but my first reaction to "How to program a text adventure in C" is to write a language / tool in C, and then use it to program the actual game much faster and safer. A Lisp-like a or a Lua-like language would both be relatively easy to implement.

Infocom was famous for using this approach, for instance.

trivo 5 minutes ago
LucasArts, too, with their SCUMM system.
kqr 3 hours ago
I have long wanted to make a procedurally generated text adventure that focuses on economics, information, and politics rather than spatial exploration. This gets complicated quickly, of course. Basic microeconomics and armchair psychology gets one a bit of the way there, but not enough to generate compelling dialogue and intrigue -- at least I have not been successful.

Does anyone know of good prior art in this space?

Minor49er 2 hours ago
Kind of sounds like Drug Wars for the TI-86+
parshua 7 hours ago
The best way to implement a text adventure in C would be to implement a simple lisp interpreter in C and then implementing the actual game in a lisp DSL. Lisp lends itself surprisingly well to this, and defining game logic declaratively instead of imperatively is much more intuitive. Here are a few examples:

[1] http://www.ulisp.com/show?383X

[2] https://github.com/mswift42/MetalHead

[3] https://github.com/xlxs4/lisp-spels/blob/main/spel.el

DougN7 6 hours ago
I haven’t used lisp is 30 years, so help me understand/remember why this would be easier than say C++ or any other language with object inheritance and virtual functions. Is there something else about it?
wduquette 5 hours ago
OO is absolutely the wrong paradigm for interactive fiction. Writing a text adventure has been my favorite way to experiment with a new language for decades now, and I’ve gone down the OO rabbit hole too many times. For this use case, you want something more like an ECS, so that a single entity can be more than one kind of thing at the same time. Consider a talking robotic vehicle. It is an object in the world: the player can interact with it from the outside. It is a room, with contents: the player can be inside it. It is an NPC: the player can speak with it. Trying to accommodate that in an OO inheritance hierarchy has always tied my code—and brain—in knots. An ECS-like architecture can handle it easily.
DougN7 4 hours ago
Thanks - I hadn’t heard of ECS before. That expanded my mind :)
scorchingjello 6 hours ago
Or replace large part of this code with lex and yacc and stick with C.
shortrounddev2 7 hours ago
That's like saying the best way to drive to New York is to drive down the block to the train station and then take a train lol
deciduously 7 hours ago
Which, generally, is true.
anthk 5 hours ago
Sorry but Inform6, which itself is a distant cousin on methodology against ZIL and ZIL itself to Lisp, it's far better than CL for these kind of games.

The English (and Spanish library -grammar, object and token translations- with INFSP6) it's something else. Among Inform Beginners' Guide, with DM4.pdf you can set anything, even new grammars, or a Tetris, if you want to dwell into low-level Inform6 functions.

Inform6 gives you literal game objects and attributes for free. The most literal OOP language ever. And the generated ZMachine games/ROMs will run from a m68k Amiga to an Iphone.

pinoy420 7 hours ago
[dead]
metabagel 12 hours ago
Section 9 - Code Generation uses awk to parse a text file to generate c files. Very nice.
3 hours ago
zabzonk 10 hours ago
I honestly think that writing an adventure can be best done by first creating an adventure-writing DSL (in C, if you like).

A few observations on the C code (I didn't read all of it):

- please, no strtok

- a little more concentration on the UI, for example not using strcmp to test inputs

- make all preprocessor definitions be uppercase

- those conditional operators confused the hell out of me - just use if/else

shortrounddev2 7 hours ago
Just use _s for each stdlib function
HexDecOctBin 7 hours ago
I thought it was going to be something like this: https://github.com/dfremont/glulx-llvm
7 hours ago
drwu 9 hours ago
I thought it was something like LPMud or MudOS [0].

[0] https://mud.fandom.com/wiki/MudOS

jeffrallen 3 hours ago
Oh man, I got PTSD (post traumatic strtok disorder) on page two and rage quitted the page.

I've lost too many hours to bad stdlib APIs.