Skip to content

Latest commit

 

History

History
130 lines (97 loc) · 6.57 KB

README.adoc

File metadata and controls

130 lines (97 loc) · 6.57 KB

Open Adventure CE 1.8.0

A port of The Colossal Cave Adventure 2.5 for your calculator.

The Colossal Cave Adventure is an adventure game, featuring a maze-like cave with treasure and monsters. The game draws elements from fantasy literature and role-playing games like Dungeons and Dragons. In Adventure, you will dodge angry dwarves, fight a dragon, and find your way through a maze (or die trying). Puzzles in the game range from easy to quite hard, and you will not get a perfect score in just a single day of playing. The original Colossal Cave Adventure game was written in 1975 through 1977; this game is one of the oldest classic computer games you can play. Guaranteed 100 % free of grues!

The Colossal Cave Adventure is the original interactive fiction game, the first text adventure game, and inspiration for many games published in the 80’s through early 90’s. Will Crowther based the initial cave on the actual Colossal Cave in Kentucky. Don Woods significantly expanded the game. In 2017 Eric S. Raymond began rewriting the awkward original FORTRAN code into something more modern and portable, a project he dubbed Open Adventure; Jason Ninneman, Peje Nilsson, Petr Voropaev, and Aaron Traas subsequently also jointed the project.

Open Adventure CE is a port of Open Adventure to the TI-84 Plus CE. For the French market, of course, the TI-83 Premium CE and Edition Python are also naturally supported.

Usage

Adventure is played using textual commands that resemble English. However, the original system Adventure was programmed on has some odd limitations, some of which are present still in this calculator port.

In particular, only the first five characters of word are examined. This means that you only need to enter the first five characters of any word. For example, the word "bottle" has six letters in it, so you can abbreviate it to bottl. Unfortunately, this also means that "northeast" is the same as "north" so you have to type ne instead to go northeast.

The input parser was the first attempt ever at natural-language parsing in a game and has some known deficiencies. Thus you get anomalies like "eat building" interpreted as a command to move to the building. These should not be reported as bugs; instead, consider them historical curiosities.

Nota bene: You cannot quit the main game just pressing MODE, DEL, or CLEAR. You must type "quit" or "save" to exit. (Alternatively, press ON, then CLEAR).

Installation

The standard LoadLib libraries GRAPHX, FILEIOC, and FONTLIBC are required, available at https://github.com/CE-Programming/libraries .

You need the Times and Dr. Sans font packs, also included. Two versions of the Times font pack are included. The Times.8xv font pack contains several font sizes unused by Adventure, so I’ve also included a Times_mini.8xv file, which only contains the font sizes used by Adventure; it saves about 30 K.

Send both ADVENT.8xp and ADVENT_data.8xv to your calculator. The program ADVENT is the game itself, while the appvar AdvenDat is the game’s dungeon data file. While changes to AdvenDat should be rare, different versions of the file are not compatible. If the game complains that the dungeon file is missing, make sure you have the right version of AdvenDat.

You will want to keep the AdvenDat appvar archived. You will otherwise run low on RAM.

Usage

Command Shortcuts

The following standard command shortcuts are available:

  • i for inventory.

  • g for get or take.

  • l for look; or alternatively, x for examine (does the same thing).

  • u and d for up and down, respectively.

  • n, e, w, and s for north, east, west, and south, respectively.

  • ne, nw, se, sw for northeast, northwest, southeast, and southwest. Note that because the text parser only looks at the first five letters of each word, those are, in fact, the only way to enter those directions!

  • y for yes and n for no.

  • z to do nothing for a turn (this may still cause other events to proceed).

Command History

While playing, you can press UP to access your command history. Press ENTER to paste the selected command. Press CLEAR to return to editing. DEL is backspace.

Saving and Resuming

To save a game currently in progress, type save. You will be prompted for a file name to give the save. If you previously resumed the game, then it will default to using the same name. If the save file was archived, it will be rearchived for you.

You can resume a game using the Resume option on the main menu. Simply use the cursor to select a save file, and then press ENTER to resume that game. You can delete a file directly from the Resume menu using the DEL key. Archived files on the Resume menu have a dot to the left of their name. You can archive a save file at the Resume screen using the STAT key. The standard resume command also still works.

Battery Saving

To prevent ruining your battery, Adventure will automatically quit after several minutes of no key presses. If you resumed a previously saved game, Adventure will automatically overwrite that save before quitting. If you’re playing a new game, you can manually set the save name using the filename command. However, if you do not set a save name, then the game will be discarded.

You can quit the game instantly at any time by pressing ON, then CLEAR. Nothing will be saved.

About Open Adventure

The homepage for Open Adventure CE is https://github.com/drdnar/open-adventure-ce . You can check there for the lastest updates, releases, and to file bug reports.

Eric S. Raymond’s home for this project is at http://www.catb.org/~esr/open-adventure . You can go there for tarball downloads and other resources related to his original PC/POSIX version of this game.

This code is a forward-port of the Crowther/Woods Adventure 2.5 from 1995, last version in the main line of Colossal Cave Adventure development written by the original authors. The authors have given permission and encouragement for Open Adventure; it obsolesces all the 350-point versions and previous 2.x (430-point) ports.

Additional information about the history of the Colossal Cave Adventure and Open Adventure is available at Eric S. Raymond’s site.

This project is called "Open Adventure" because it’s not at all clear how to number Adventure past 2.5 without misleading or causing collisions or both. See Raymond’s history file for discussion. The original 6-character name ADVENT on the PDP-10 has been kept for the retro feel.