README

Addventure 1.2

What is Addventure?

Addventure is a text-based adventure game with a slight twist - users are allowed to add new "rooms" to the adventure as they encounter scenarios that haven't been created yet. In this way, the game is constantly growing and can take on new and unique twists.

Detailed instructions are available and should be made available for the players.

Needed for installation

A C++ compiler. (Tested wtih GCC)
My CGI Script object library. (Should be in the same place you found this.)
A http server. (Tested with NCSA httpd 1.1 and 1.3)
A script directory the Addventure binaries can be placed in (this can be the normal cgi-bin directory, or another one).
A directory to store the files that the server has write access to.

Installation

Install the CGI Script library.
Uncompress and untar the addventure file. (Seriously?)
Edit the Makefile
- Change the CC and CFLAGS lines to suit your tastes
- Change INCDIR and LIBDIR to point to the location of the CGI Script library and header files
- Make sure one of the UMASK lines is uncommented. The first one is best for programs that run setuid, the second is best when files are permitted to the same group the server runs as.
- Change BINPATH to point to the location of the Addventure executable. This path should be relative to the http server root.
- Change ABSFILEPATH to point to the absolute location of the Addventure data files. This path should be relative to the root directory of the file system.
- Change RELFILEPATH to point to the location of the Addventure data files relative to the http server root.
- You shouldn't need to change anything else in the Makefile.
Make sure the directories you specified above exist and are writable by the server, or that the programs are going to run setuid.
Enter make to create the makefirst, textproc, and optproc programs.
Run the makefirst program. It will create the first two rooms and support files for the Addventure (overwriting any previous rooms in the directory).
Manually copy the textproc and optproc programs to the BINDIR directory.
If necessary, chmod the programs to run setuid.
Install the help file somewhere.
Cereate any hyperlinks to the first room and the help file that you desire.
Addvertise {:

Known Bugs

There is no file locking, so users who both try to write to the same file will cause unexpected results.
No failure is reported if the server is unable to write to the data files. This is usually caused, however, by incorrect directory or file permissions.

Please report all bugs to

prisoner@acm.rpi.edu

Changes from previous versions

Version 1.1 -> Version 1.2

New administrator features.

Added wiperoom to help clean up old rooms.

Version 1.0 -> Version 1.1

Maintenance release to fix a couple of bugs and attempt to eliminate dead-end rooms.

Using cgi-query library version 1.1
- Alows for unlimited length text/data fields
No longer allows for zero options
Added the "Reject" link to parent. Allows player to avoid editing a room
File permissions are now controlable.
Removed debugging options
Entry to a room now tries to defeat the cache.

Version 0.0 -> Version 1.0

This is the first release of Addventure for the Web. (It has previously been written for UNIX, DOS, and a private BBS.)

Updated code to use the CGI Script library
Paths no longer hard-coded.
Hidden inputs in the forms are now better formatted and identified.
Created makefirst to create the initial rooms.

Credits

Author: Allen S. Firstenberg -
prisoner@acm.rpi.edu
Thanks to: Lori Doyle and Gene Homicki