Blindfold removal fix
[slashemextended.git] / readme.txt
blobfc63aa4bf52b59116bce17d904d0427133a7afb6
1 +------------------------------------------------------------------------+
2 |                              README.TXT                                |
3 +------------------------------------------------------------------------+
4 |                          SLASH'EM ver 0.0.7                            |
5 |               Super Lotsa Added Stuff Hack - Extended Magic            |
6 |                           A Nethack Variant                            |
7 | Courtesy of the Slash'EM development team with the efforts and support |
8 | of countless others, especially the slashem-devel mailing list.        |
9 |                                                             (1997-2007)|
10 +------------------------------------------------------------------------+
11 | Nethack is Copyright 1985-2003                                         |
12 |            By Stichting Mathematisch Centrum and M. Stephenson.        |
13 | SLASH'EM and NetHack may be freely redistributed.                      |
14 | See license in the dat directory for details.                          |
15 +------------------------------------------------------------------------+
17 +-------+
18 | Index |
19 +-------+
21 1 - News
22         1.1 Status
23         1.2 Changes
24 2 - Getting started
25         2.1 Using official binaries
26         2.2 Playing the game
27         2.3 Building it yourself
28 3 - What is the Nature of this Beast?
29 4 - Who is Responsible & The Credits
30         4.1 The dev-team
31         4.2 Acknowledgements
32 5 - Further reading
34 +-----------------+
35 | Section 1: News |
36 +-----------------+
38 1.1 Status
39 ----------
41 The development of version 0.0.7 of Slash'EM started with version 0.0.6E5
42 (yes, we realise our version numbers are a little odd - it made sense at
43 the time!). Version 0.0.7E6 was the first beta release.
45 If you find any bugs then please submit a report via the offical bug page:
47 http://sourceforge.net/bugs/?group_id=9746
49 If you are interested in the development of Slash'EM, please also join
50 the slashem-devel mailing list so that you can take part in discussions
51 and give us any feedback.
53 If you'd just like to talk about Slash'EM with other players or chat to
54 the developers, then please join the slashem-discuss mailing list.
56 Finally, all users are encouraged to join the slashem-announce list,
57 which is very low traffic but will keep you up to date on new versions.
59 Slash'EM mailing list page (including archives):
61 http://sourceforge.net/mail/?group_id=9746
63 All the above, and more, are available via our home page:
65 http://www.slashem.org/
67 1.2 Changes
68 -----------
70 ver 0.0.7E7F4 [?] [Released by ?]
71 -fixed bug 1612361: Strange behaviour when selling medical kit
72 -fixed bug 1681811: Ring of levitation - "Lev" status changes late
73                     (paranoid_times)
74 -fixed bug 1691722: Grammar - "an a basilisk corpse"
75 -fixed bug 1708141: "the" in "the Rat King" uncapitalized when eating corpse
76                     (Kernigh)
78 See history.txt for changes made in previous versions.
80 +----------------------------+
81 | Section 2: Getting started |
82 +----------------------------+
84 2.1 Using official binaries
85 ---------------------------
87 The Slash'EM development team make offical binaries available for a few
88 platforms. There are other, unofficial, binaries available as well which
89 will come with their own instructions.
91 2.1.1 DOS
92 ---------
94 Support for this platform is sporadic at best. You may find you have to
95 use an unofficial binary. When an official binary is provided:
97 o Decompress the zip archive into its own directory.
98 o Use a text editor to review defaults.nh and make any changes needed.
99 o If you chose to keep the fancy graphical environment (the allegro
100   interface) by leaving video set to autodetect, then review alleg.cnf
101   as well (this file is ignored in VGA tile mode).
102 o Run the slashem executable.
104 2.1.2 MAC
105 ---------
107 The MAC binary comes with its own documentation which you should consult.
109 2.1.3 Linux RPMs
110 ----------------
112 Perform the following steps:
114 o Install the package using rpm -U <package file>
115 o Read the RPM specific documentation in README.RPM
116 o In case of difficulty, consult Ali's linux page:
118   http://www.juiblex.co.uk/nethack/slashem/linux.html
120 2.1.4 MS-Windows
121 ----------------
123 Perform the following steps:
125 o Download the core package and install it. This will allow you to play
126   Slash'EM using the native gui (common controls) windowing interface.
127 o If you would prefer to use the console (tty) windowing interface, then
128   you need to edit the defaults.nh file and set the windowype option to
129   tty by uncommenting the relevant line.
130 o If you would prefer to use GTK, an alternative graphical windowing
131   interface, then you need to download and install the GTK add-on package
132   as well. You will also need a copy of the gtk-win runtime environment
133   version 2.2.1 or above. This is available from http://www.dropline.net/gtk
134 o Use a text editor to review either or both copies of defaults.nh and
135   make any changes needed.
136 o If you chose to install the GTK add-on interface, then review gtkrc
137   as well.
138 o Use the start menu or desktop icons to play Slash'EM under your
139   preferred windowing interface.
141 2.2 Playing the game
142 --------------------
144 Once in the game, type in the name for your alter ego.  You will then
145 be prompted to select your character's role and race.  Select a gender
146 and alignment, if necessary.  Once you're on the dungeon map, use the
147 number pad to move around (or the standard roguelike keys [yuhjklbn],
148 if your turn off number_pad).  Move into monsters to attack them.
149 Help is the '?' key, inventory is 'i'.
151 Try out the menu system by hitting the ` key.
153 2.3 Building it yourself
154 ------------------------
156 If you don't already have a copy of the source code for Slash'EM then
157 get the source tarball via our homepage:
159 http://www.slashem.org/
161 Then read the installation instructions specific to your platform,
162 as follows:
164         Amiga           sys/amiga/Install.ami
165         Atari           sys/atari/Install.tos
166         MAC             sys/mac/Install.mpw
167         MS-DOS          sys/msdos/Install.dos
168         OS/2            sys/os2/Install.os2
169         UNIX            sys/unix/Install.unx
170         VMS             sys/vms/Install.vms
171         MS-WinCE        sys/wince/Install.ce
172         MS-Win32        sys/winnt/Install.gcc
174 +----------------------------------------------+
175 | Section 3: What is the Nature of this Beast? |
176 +----------------------------------------------+
178 THE PROBLEM:  The AMULET OF YENDOR has been stolen.  Not only that but
179 it appears that the Wizard of Yendor (not a nice person), who took the
180 amulet, is hiding in the Dungeons of Doom (not a friendly place).
182 The SOLUTION:  Well, armies have been suggested.  Maybe hiring a superhero
183 or two.  Unfortunately, it seems that it is more economical to offer a
184 reward and let some poor adventurer with dreams of glory go and get it.
185 Guess who's got the enviable job of saving the day...
187 Super Lotsa Added Stuff Hack - Extended Magic (SLASH'EM) is a role-playing
188 game where you control a single character.  The interface and gameplay
189 are similar in style to Rogue, ADOM, Angband and, of course, Nethack.
190 You control the actions through the keyboard and view the world from an
191 overhead perspective.
193 +--------------------------------------------+
194 | Section 4: Who's Responsible & The Credits |
195 +--------------------------------------------+
197 4.1 The dev-team
198 ----------------
200 o Project administrators: Warren Cheung and J. Ali Harlow
201 o Developers: Pekka Rousu and Clive Crous
202 o Mac port: Paul Hurtley
204 4.2 Acknowledgements
205 --------------------
207 Thanks to Andrew Apted, who contributed the glHack interface.
209 Thanks to Kevin Hugo (hugo@cae.wisc.edu), the previous Macintosh
210 maintainer and the author of many changes, who has had to move on to
211 other projects.
213 Thanks to Dirk Schönberger (shoenberger@signsoft.com), who worked on
214 the Qt and Linux ports.
216 Thanks to Ben Olmstead for mirroring the homepage.
218 Thanks for the support, bug reports and suggestions of
219 (in no particular order):
221         Pat Rankin, Linley Henzell, 0ystein Kerstad, Jim Miller, pi,
222         Steven Uy, Alex Critchfield, Mike Balcom, Sascha Wostmann,
223         Drew Curtis, Daniel Krause, E. P. Dinklewhopper, Tim Jordan,
224         Lukas Geyer, Kresimir Kukulj, Brent Oster, Travis McKay,
225         Jared Withington, Philippe-Antoine Menard, Ain Uustare,
226         Doug Yanega, David Tang, Lief Clennon, Robert Herman, Petra Prinz,
227         Aki Lumme, Nick Number, Robin Johnson, Heiko Niemeier, Chris Bevan,
228         David Damerell, Kevin Hugo, Daniel Mayer, Ben Olmstead, Tom Friedetzky,
229         Kalle Niemitalo, Sabine Fischer, Christian Bressler, Jake Kesinger,
230         Chris Subich, Paul Sonier, Peter Makholm, Matthew Ryan, J. Ali Harlow,
231         George Stephens, Bruce Cox, Edward Walker, Karl Garrisson,
232         Finn Theoderson, Kelly Bailey, Seth Friedman, Jonathan Nieder,
233         Eva R. Myers, Darshan Shaligram, Tina Hall, Christian Cooper.
235 +----------------------------+
236 | Section 5: Further Reading |
237 +----------------------------+
239 o Slash'EM Homepage: http://www.slashem.org/
240 o Ali's Slash'EM page: http://www.juiblex.co.uk/nethack/slashem.html
241 o Eva's spoiler page: http://www.statslab.cam.ac.uk/~eva/slashem/index.html