colossal-cave-adventure - text adventure of exploration in Colossal Cave
Contents
Commands
Interactwiththegame
At the > prompt, type one‐ or two‐word commands to specify what to do next:
WELCOME TO ADVENTURE!! WOULD YOU LIKE INSTRUCTIONS?
> no
YOU ARE STANDING AT THE END OF A ROAD BEFORE A SMALL BRICK BUILDING.
AROUND YOU IS A FOREST. A SMALL STREAM FLOWS OUT OF THE BUILDING AND
DOWN A GULLY.
> goeast
YOU ARE INSIDE A BUILDING, A WELL HOUSE FOR A LARGE SPRING.
THERE ARE SOME KEYS ON THE GROUND HERE.
THERE IS A SHINY BRASS LAMP NEARBY.
THERE IS FOOD HERE.
THERE IS A BOTTLE OF WATER HERE.
> getlamp
OK
> leave
YOU'RE AT END OF ROAD AGAIN.
> gosouth
YOU ARE IN A VALLEY IN THE FOREST BESIDE A STREAM TUMBLING ALONG A
ROCKY BED.
The original Adventure paid attention to only the first five letters of each command, so a long command
like inventory could simply be typed as inven. This package defines a symbol for both versions of every
long word, so you can type the long or short version as you please.
Savethegamestate
You can save the current state of your game at any time with the saveSAVEFILE command:
> savemygame
GAME SAVED
> quit
DO YOU REALLY WANT TO QUIT NOW?
> y
OK
Copyright
Copyright © 2014–2022 Ben Finney.
python-adventure 2022-02-25 COLOSSAL-CAVE-ADVENTURE(6)
Description
ColossalCaveAdventure is a text adventure game of exploration.
Somewhere nearby is Colossal Cave, where others have found fortunes in treasure and gold, though
it is rumored that some who enter are never seen again.
Originally named “ADVENT” or “Adventure”, this is the first known work of interactive fiction. As the
first text adventure game, it is considered the precursor for the adventure game genre.
In the game, you control a character through simple text commands to explore a cave rumored to be filled
with wealth. You earn predetetermined points for acquiring treasure and escaping the cave alive, with
the goal to earn the maximum amount of points offered.
This is a re-implementation of the “350-point” version, using the same game content from the original
Crowther and Woods PDP-10 source code of the late 1970s.
It uses the original text exactly, and emits responses slow enough to read as the contemporary terminal
interfaces did.
History
This is an implementation of the ColossalCaveAdventure game, originally written in 1975–1977 by Will
Crowther and Don Woods. Crowther's original source code, which had been presumed lost for decades, was
recovered in 2005 from a backup (dated 1977-03) of Don Woods's student account on the PDP-10 computer at
the Stanford Artificial Intelligence Lab (SAIL).
This is the adventure distribution, ported from the 1977 FORTRAN code to Python 3 by Brandon Craig
Rhodes.
Invocation
Beginagame
Run the command colossal-cave-adventure in a terminal to begin the game:
$ colossal-cave-adventure
WELCOME TO ADVENTURE!! WOULD YOU LIKE INSTRUCTIONS?
>
Restorethegamestate
If you saved the game state with the in-game saveSAVEFILE command, you can restore the game to the same
state by specifying the SAVEFILE name when you invoke the program:
$ colossal-cave-adventuremygame
GAME RESTORED
>
Name
colossal-cave-adventure - text adventure of exploration in Colossal Cave
Notes
Speedofoutput
For extra authenticity, the output of the Adventure game is typed to your screen at 1200 baud. You will
note that although this prints the text faster than you can read it anyway, your experience of the game
will improve considerably, especially when a move results in a surprise.
Why is the game better at 1200 baud? When a paragraph of text is allowed to appear on the screen all at
once, your eyes scan the entire paragraph for important information, often ruining any surprises before
you can then settle down and read it from the beginning. But at 1200 baud, you wind up reading the text
in order as it appears, which unfolds the narrative sequentially as the authors of Adventure intended.
Options
PositionalArgumentsSAVEFILE
The filename of game you have saved.
OptionalArguments--help, -h
Describe how to use the program.
Synopsis
colossal-cave-adventure [SAVEFILE]
colossal-cave-adventure-h