home *** CD-ROM | disk | FTP | other *** search
/ GameStar Special 2004 August / GSSH0804.iso / Rollenspiele / Nethack / nethack-343-win.exe / README < prev   
Text File  |  2003-10-15  |  16KB  |  354 lines
  1. NetHack is Copyright (C) Stichting Mathematisch Centrum, Amsterdam 
  2. and M. Stephenson. NetHack may be freely redistributed.  
  3. See license for details.
  4.  
  5.                 NetHack for Windows
  6.                   =================================
  7.          (last revision: $Date: 2003/10/15 11:00:01 $)
  8.  
  9. ------------------------------------------------------------------------
  10. Hello ..., Welcome to NetHack 3.4.3!
  11. ------------------------------------------------------------------------
  12.  
  13. NetHack for Windows platforms is available in source code
  14. distribution from http://www.nethack.org/ or in a ready-to-run
  15. binary format.
  16.  
  17. The NetHack 3.4.3 official binary distribution of NetHack for 
  18. Windows 3.4.3 contains two separate executables inside it.
  19.  
  20. There is the "NetHack for Windows - tty interface" which
  21. will run on any platform offering the win32 Console I/O
  22. support. This is the executable that was included in
  23. NetHack releases prior to 3.4.0.
  24.  
  25. NetHack 3.4 also includes the
  26.  "NetHack for Windows - Graphical Interface" 
  27. which should run on any of the platforms listed below,
  28. with the following restrictions noted via the
  29. asterisk:
  30.  
  31.     Windows 95*
  32.     Windows 98
  33.     Windows Me (untested)
  34.     Windows NT 4.0*
  35.     Windows 2000
  36.     Windows XP
  37.  
  38. (* indicates that it requires updated common control libraries. The 
  39.    minimal common control library versions required is 4.71. You can 
  40.    get that version or greater by downloading the common control 
  41.    library from Microsoft at this URL (valid at time of production of 
  42.    this document: 
  43.      http://www.microsoft.com/downloads/details.aspx?FamilyID=6f94d31a-d1e0-4658-a566-93af0d8d4a1e&DisplayLang=en
  44.    As well, please refer to the notes for this binary at:
  45.      http://www.nethack.org/)
  46.  
  47.  
  48. ------------------------------------------------------------------------
  49. Release notes about NetHack for Windows 3.4.3
  50. ------------------------------------------------------------------------
  51.  
  52. Save and bones files created with version 3.4.0, 3.4.1, or 3.4.2 should 
  53. work with 3.4.3. Save and bones files created with versions earlier than 
  54. 3.4.0 definitely won't work.
  55.  
  56. As with earlier 3.4.x versions, 3.4.3 has a whole bunch of defaults.nh 
  57. options for controlling layout and fonts used in the 
  58. "NetHack for Windows - Graphical Inteface."  The best source of information 
  59. about those at the present time is the Windows specific help from within 
  60. the game.
  61.  
  62. recover.exe is no longer bundled into the binary distribution because
  63. recover functionality has been included in NetHack itself for Windows
  64. platforms.
  65.  
  66. Check the Guidebook, news file, and defaults.nh for information
  67. on working with international keyboards, and the "altkeyhandler" 
  68. and "subkeyvalue" config file options.
  69.  
  70. perm_invent support did not make it into either win32 interface 
  71. in time for the 3.4 release.
  72.  
  73. ------------------------------------------------------------------------
  74. How to set up the game:
  75. ------------------------------------------------------------------------
  76.  
  77. In order to install this particular version of NetHack, you will need a PC
  78. running one of the versions of Windows listed earlier.  Let it be known
  79. that we, on the development and win32 porting teams, have not actually tried
  80. to use the binary on a Windows Me platform.  We are not aware of any reason 
  81. that it won't work, but let us know if it doesn't.
  82.  
  83. The most straightforward method of setting up the game is to unzip all of
  84. the NetHack files into a single directory - C:\GAMES\NETHACK would be
  85. a typical choice, but certainly not a required one. 
  86.  
  87. To invoke "NetHack for Windows - Tty Interface" run the 
  88. nethack.exe executable.
  89.  
  90. To invoke "NetHack for Windows - Graphical Interface" run the
  91. nethackw.exe executable.
  92.  
  93. Save files and bones files should be completely 
  94. compatible between the graphical and tty versions.
  95.  
  96. Next, you quite likely want to poke around in the file "defaults.nh"
  97. with a text editor to set up pragmatic things (like where to
  98. store saved games or bones files), aesthetic things (like whether to 
  99. use traditional ASCII characters or graphical tiles, which font etc.), 
  100. and Fun Stuff (like the name of your character and your pet).
  101.  
  102.     With luck the comments in "defaults.nh" should be adequate to
  103. at least get your started figuring out how things work. Oh, and by
  104. the way, read the Guidebook and the in-game Windows help.  It's 
  105. The Guidebook is stored in the binary distribution as Guidebook.txt.
  106.  
  107.  
  108. ------------------------------------------------------------------------
  109. Contacts:
  110. ------------------------------------------------------------------------
  111.  
  112.  
  113. If you discover a bug and wish to report it, or if you have comments
  114. or suggestions we recommend using our "Contact Us" web page at:
  115.     http://www.nethack.org/common/contact.html
  116.  
  117. If you don't have access to the web, or you want to send us a patch
  118. to the NetHack source code feel free to drop us a line c/o:
  119.     DevTeam (at) nethack.org
  120.  
  121. Happy NetHacking!
  122.  
  123. Please mention which of the 'official' nh3.4.3 binaries you are using,
  124. assuming that you are.  If you aren't, please be sure to mention that
  125. fact. When you do, also mention exactly what you changed and what 
  126. steps you followed between the time you downloaded the source, and you
  127. contacted us.
  128.  
  129. ------------------------------------------------------------------------
  130. Frequently asked questions:
  131. ------------------------------------------------------------------------
  132.  
  133. You asked:
  134.  
  135.     I try to start up "NetHack for Windows - Graphical Interface",
  136.     but it keeps starting as the tty version. How do I get the
  137.     graphics?
  138.  
  139. Our RTFM expert replies:
  140.  
  141. There are two executable programs included in the binary distribution.
  142. You have to run the one called "nethackw.exe" to get the graphical
  143. version.  If you ran "nethack.exe", you'll get the tty version. Do it
  144. over, and do it right this time.
  145.  
  146.  
  147. You asked:
  148.  
  149.     Ok the game works.  Where do I begin to learn how to play?
  150.  
  151. A passing strange person replies:
  152.  
  153. Of course it works.  What do you think I am, a radio?
  154.     Once you've got into the game, some good commands to try (and
  155. they don't even count as moves!) are ? and /.  At risk of sounding
  156. like a marketing blurb, the HELP key (which on your terminal will be
  157. marked with a question mark - and be warned that you may have to
  158. depress the shift key to activate this function!) gives you instant
  159. access to our online help facility.  It's kind of a menu with lovely
  160. options like "c" (where you get to see MY NAME in the history of
  161. NetHack!), "i" (which gives you all the important legal blurb which
  162. tells you about your rights and responsibilities as a NetHack
  163. licensee), and the more boring items "a" and "b" which merely explain
  164. all the commands and the display symbols and uninteresting stuff like
  165. that.  What the hell.  It's there, you can use it.
  166.     The / key is pretty good, too.  If there's something on the
  167. screen that you don't know what it is, well, it's probably a letter or
  168. a symbol or something.  That's wisdom, see?  But to get onto the
  169. Eternal Verities, suppose you want to know what it MEANS?  Aha!  Hit
  170. /, say "y", I want to specify it by cursor (cursors are blinking
  171. underscores, and if you're British like me you can curse them with
  172. your numeric bloody keypad, too -- Americans needn't understand this
  173. joke), whatever it is, and then you can point out the object of your
  174. confusion and have it explicated in frabjous detail.  Helps you avoid
  175. getting your face et, sometimes, that.  Always nice, not having your
  176. face et.
  177.     Oh, right, I almost forgot.  There's the Guidebook, too, for
  178. the quiche-eaters in our midst....  You may have got one with your
  179. game in the form of a file called Guidebook.txt.
  180.  
  181.  
  182. You asked:
  183.  
  184.     Are ASCII characters my only choice for representing things
  185. on the display?
  186.  
  187. A worker tiling our floor responds:
  188.  
  189. I've been in this business for twenty years.  All the people 
  190. today want to change things!  There's a lot to be said for the 
  191. traditional way of doing things.  On the other hand I can 
  192. provide you with a set of NetHack tiles, that will give 
  193. your display a completely different look.
  194. If you want to try tiles on the NetHack display, place an 
  195.     OPTION=map_mode:tiles 
  196. line into the "defaults.nh" file and run nethackw.exe. If you 
  197. have a custom set of tiles, such as a 32x32 tile set called chozo32b.bmp, 
  198. then you should also add the following line to your "defaults.nh":
  199.       OPTION=OPTIONS=tile_file:chozo32b.bmp, tile_width:32, tile_height:32
  200.  
  201.  
  202. You asked:
  203.  
  204.     I like the graphical version, because I get to use
  205. my mouse for more than just a paper-weight.  But I *like*
  206. ASCII characters. I've been using ASCII characters for
  207. NetHack since I was in high school.  Can't I have my cake
  208. and eat it too?
  209.  
  210. The baker dropping off our daily doughnut supply says:
  211.  
  212. Did somebody mention cake?  Have I got a recipe for you!
  213. Take (1) defaults.nh
  214. Add  (1) lines of OPTION=map_mode:ascii8x12
  215. Save it, and stir. Presto - an ASCII display on the
  216. graphical screen...or is that a graphical display on the 
  217. ASCII screen...I can't remember - try it yourself.
  218.  
  219.  
  220. You asked:
  221.  
  222.     Eeewwww. I hate the font the graphical version
  223.     is using on the message window.  I like the 
  224.     PrestoWizBang font that I got last week. Can 
  225.     you change it for the next version, please?
  226.  
  227. Our staff Salesperson replies:
  228.  
  229. Why wait?  You can have it now!  Don't delay, add
  230. an OPTIONS=font_message:PrestoWizBang, font_size_message:10
  231. PrestoWiz corporation assumes no responsibility for the
  232. use of their font on NetHack, and all such use is without
  233. warranty and at your own risk.  If you act now, I can
  234. throw in a couple of Ginsu knives at no extra cost.
  235.  
  236.  
  237. You asked:
  238.  
  239.     Wow this is a really neat game.  Is there any way to explore it
  240.     without dying so much?
  241.  
  242. Our staff schizophrenic replies:
  243.  
  244. Gentle Reader, I fear this is a most delicate question.  It is a
  245. frequent theme in fantasy literature that it is far easier to be
  246. granted a wish than it is to decide upon a good wish to make.  But I
  247. am no djinn, and I am willing to advise you on this point as well.
  248. And so I shall make the observation that, no matter what transpires,
  249. you will always die the same amount, viz: once.  (Unless of course
  250. some sort of magic intervenes.)  Perhaps what you want is a way to
  251. avoid dying so soon?
  252.     As it happens, this latter can be accomplished.  Death, as it
  253. transpires, is characterisable as _finitely avoidable_ in NetHack, for
  254. there is a Mystic Prompt known to those who have read the Man Page of
  255. Doom, the words of which, it is sometimes whispered, are as follows:
  256.         Die? [yn]
  257. The benefit of being asked this question at the, shall we say,
  258. appropriate, crucial moments is available -- for a price.
  259. Classically, an acceptable consideration would be the player's soul;
  260. but since according to the hallowed doctrines of most major religions,
  261. @-signs don't have souls to sell, we will be contented with your
  262. score....  For lo!  The game contains an X command, and by the
  263. strangely inexplicable power of the elder gods this X standeth for the
  264. word Discover (or EXplore, in the ancient tongue), and the typing of
  265. this Mystic Device shall effect the deal as described above,
  266. paragraphs 2 and 3.
  267.     Furthermore, and alternately, IF YOU ORDER IMMEDIATELY at the
  268. outset of a game, AS AN ADDED FREE BONUS YOU WILL RECEIVE A GENUINE
  269. HAND-CRAFTED WAND OF THREE WISHES!  Just type NETHACK -X (or
  270. NETHACKW -X if you are more graphically inclined) on the
  271. command line and, since NetHack is freely distributable, SEND NO MONEY
  272. NOW.  As a variation on this theme, the -D flag will put the game into
  273. its debugging mode, IF you are a wizard... "Speak, wizard, and enter",
  274. to paraphrase the Old Master.
  275.  
  276.  
  277. You asked:
  278.  
  279.     I was playing along with my 400 hitpoint level 8 Barbarian
  280.     named Gorp and my dog Gumby, having a wonderful evening bashing
  281.     heads, eating eye corpses, and generally running amok in the dungeon
  282.     and all of a sudden the (1) the lights go out, (2) I hit the power
  283.     cord with my sword, (3) lightning struck, or (4) the game actually
  284.     crashed.  Now what do I do?
  285.  
  286. Our resident disaster recovery expert replies:
  287.  
  288. WHAT? Damn, hmmm, lets see now. Where is the plan, you know what I 
  289. mean, the PLAN! Wait, now calm down, let me think. Hmm. Hmm. Oh 
  290. yea! You have INSURANCE don't you. I mean you compiled the game 
  291. with INSURANCE didn't you. Well then you are in safe hands, so to 
  292. speak. Included at no extra charge to you is a recovery feature. 
  293. Its sole purpose in life is to save your behind in cases like this. 
  294. Don't go getting the idea that you can cheat by turning off your 
  295. machine just when you are about to die and using it to resurrect 
  296. your Wizard. The recovery mechanism can tell you are cheating and will 
  297. delete your high score list and give you bad luck for twenty games. 
  298.  
  299.     To engage the recovery feature after a crash just start your game 
  300. with the same player name as you used with the one that crashed. 
  301. Forgotton what player name you used? Go to your NETHACK directory 
  302. and check to see if you have a bunch of files ending in a number. 
  303. Like so: ELVIS-PRESLEY.0 ELVIS-PRESLEY.1 ELVIS-PRESLEY.2 and so on. 
  304. Your player name is the part after the '-', and before the '.'. 
  305.  
  306. Example you say:
  307.  
  308. nethack -uPRESLEY
  309.  
  310. NetHack should detect the earlier failed game and ask you if you
  311. want to recover. Answer yes. Works. 
  312.  
  313.     Good enough?
  314.  
  315.  
  316. ------------------------------------------------------------------------
  317. DISCLAIMERS:
  318. ------------------------------------------------------------------------
  319. Throughout this document, the word "NetHack" refers to a rather jolly
  320. game involving a small @-sign getting its face et by dragons, and is
  321. in no way to be construed as relating to the theory or practise of
  322. gaining unauthorised use of or access to data or data processing
  323. equipment (except maybe if a few of us play the game at work,
  324. something which I want to go on record as saying is very, very naughty
  325. indeed and not the sort of thing you want to get involved with at
  326. all), and if any security-establishment types are reading this,
  327. remember it's YOU folks who do the cloak-and-dagger stuff, we're
  328. responsible professionals with real jobs and self respect and stuff
  329. like that.
  330.  
  331. Secondly, all references to animal sacrifice, Donny Osmond (who?), 
  332. dynamic linking, Microsoft Corporation, okapi, claviprondrophony and 
  333. so forth are made purely for the entertainment of the reader and if 
  334. you think we meant something by it, that's your problem.  Research has 
  335. shown that what people say and what they mean have so little to do with
  336. each other that you can actually get PAID to figure out why people say,
  337. "can you reach the salt?" when as a matter of fact they don't give a
  338. pair of dingo's kidneys what the answer to the question is, so long as
  339. someone provides them with some small white crystals in the near
  340. future and look! you came up with *that* interpretation all by
  341. yourself now didn't you.
  342. ------------------------------------------------------------------------
  343. Special thanks to stephen p spackman who wrote the original version
  344. of this text and who will live forever in our memories.  (Nope, he
  345. isn't dead, just moved on to a higher calling).
  346. ------------------------------------------------------------------------
  347.  
  348. This document is Copyright (C) 1991 Stephen P Spackman and Kevin D
  349. Smolkowski (1993).  It constitutes part of the documentation of the PC
  350. and Windows versions of the NetHack game, and may be distributed freely 
  351. subject to the same terms set forth in the NetHack license.  Thank you 
  352. for having a very nice day indeed.  Hack On!
  353.  
  354.