NAME

       colossal-cave-adventure - text adventure of exploration in Colossal Cave

SYNOPSIS

       colossal-cave-adventure [SAVEFILE]

       colossal-cave-adventure -h

DESCRIPTION

       Colossal Cave Adventure 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.

OPTIONS

   Positional Arguments
       SAVEFILE
              The filename of game you have saved.

   Optional Arguments
       --help, -h
              Describe how to use the program.

INVOCATION

   Begin a game
       Run the command colossal-cave-adventure in a terminal to begin the game:

              $ colossal-cave-adventure
              WELCOME TO ADVENTURE!!  WOULD YOU LIKE INSTRUCTIONS?

              >

   Restore the game state
       If  you saved the game state with the in-game save SAVEFILE command, you can restore the game to the same
       state by specifying the SAVEFILE name when you invoke the program:

              $ colossal-cave-adventure mygame
              GAME RESTORED
              >

COMMANDS

   Interact with the game
       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.

              > go east
              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.

              > get lamp
              OK

              > leave
              YOU'RE AT END OF ROAD AGAIN.

              > go south
              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.

   Save the game state
       You can save the current state of your game at any time with the save SAVEFILE command:

              > save mygame
              GAME SAVED
              > quit
              DO YOU REALLY WANT TO QUIT NOW?
              > y
              OK

NOTES

   Speed of output
       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.

HISTORY

       This  is  an  implementation of the Colossal Cave Adventure 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  ⟨https://pypi.python.org/pypi/adventure/⟩,  ported  from  the  1977
       FORTRAN code to Python 3 by Brandon Craig Rhodes ⟨brandon@rhodesmill.org⟩.

COPYRIGHT

       Copyright © 2014–2022 Ben Finney ⟨bignose@debian.org⟩.