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