view rogue3/INSTALL.txt @ 83:09db0cf536af

Properly handle invalid room references in savefiles. In all games, rs_write_room_reference() stored -1 for a nonexistent room, but rs_read_room_reference() did not check for out-of-bounds values, leading to pointers to rooms[-1], which sometimes caused crashes. rs_read_room_reference() has now been modified to use NULL instead. Some of the games required further changes to replace NULL with the pointer to the actual room. Others are capable of handling NULL for objects not in any room.
author John "Elwin" Edwards
date Thu, 08 Aug 2013 12:41:35 -0700
parents 9223b6d7a243
children c9c6bb34734d
line wrap: on
line source

		       Roguelike Gallery (rlgallery.org)

This is the source code for the Roguelike Gallery's version of Rogue V3.

History
Rogue 3 was released by Michael Toy, Ken Arnold, and Glenn Wichman, probably 
late in 1980.  It went through several minor updates.  The last, Rogue 3.6, 
was completed mid-June 1981.

The Roguelike Restoration Project (rogue.rogueforge.net) updated the game to 
work on modern systems.

The Roguelike Gallery's version has been slightly modified for compatibility 
with dgamelaunch and security for multiple players.

Installing
First, configure for your system by editing machdep.h.  The defaults are for a 
system-wide installation, which will require setgid on the binary.  For a 
single-user installation, comment out SAVEDIR and set SCOREFILE and LOGFILE to 
locations somewhere in your home directory.  (That's probably the best thing to 
do on Windows, too.)

Once that's finished, compile by running make.  (I haven't tested the Visual 
Studio project files on Windows, but they should work.)

If you want multi-user play, install the rogue3 binary with setgid games.  You 
will need to make sure that SAVEDIR exists and that savefiles, SCOREFILE, and 
LOGFILE can be created and written by the games group (assuming you want those 
features.)  For a single user, installing shouldn't be necessary.

Playing
For more details, see readme36.html (contains the man page) and rogue36.html 
(Michael Toy's "Guide to the Dungeons of Doom").

Contact
rlgallery.org admin: John "Elwin" Edwards <elwin@sdf.lonestar.org>