home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / games / nethack.README < prev    next >
Encoding:
Text File  |  1994-01-07  |  6.6 KB  |  136 lines
  1.  
  2.         NetHack 3.0 -- General information
  3.  
  4. NetHack 3.0 is a new generation of the dungeon exploration game NetHack.
  5. It is a distant descendent of Hack, and a direct descendent of NetHack 2.3.
  6. It is the product of a year-long, very intensive, international team
  7. effort.  Many parts of 2.3 were rewritten for NetHack 3.0, and many new
  8. features were added.  Judged by size alone, with all options enabled,
  9. NetHack 3.0 is twice as big as 2.3.
  10.  
  11. While aiming at retaining the general atmosphere of NetHack 2.3, we sought
  12. to open up new directions of development for the game.  Alignment, both for
  13. player characters and for monsters, was introduced.  Player character
  14. attributes were added and integrated into the game.  Special compiled
  15. levels were added, and these open up endless future possibilities.  An
  16. endgame was written, for a climactic ending.  The code for monsters and
  17. objects was massively rewritten, and many new creatures and items were
  18. added.  The self-polymorph code was debugged and greatly enriched.  Shops,
  19. too, were enhanced.  There are now doors in doorways and chests that may
  20. contain valuables, both of which may be closed or locked.  New commands to
  21. open or kick doors and force locks on chests were added.  You can also use
  22. kicking as an attack mode, and you can kick objects around if it pleases
  23. you.  You will discover the rest for yourselves...
  24.  
  25. To compensate for the massive additions, we rewrote the code around some
  26. new map fields for an increase in speed up to, if not beyond, that of 2.3.
  27. The code is now organized, and nearly lint-free.
  28.  
  29. We dedicate the game to the many unknown hackers, both past and future, who
  30. contribute so much to the game.
  31.  
  32.             - - - - - - - - - - -
  33.  
  34. Please read items (1), (2) and (3) BEFORE doing anything with your new code.
  35.  
  36. 1.  Unpack the code in a dedicated new directory.  We will refer to that
  37.     directory as the 'Top' directory.  It makes no difference what you
  38.     call it.
  39.  
  40. 2.  If there is no flaw in the packaging, SEVEN sub-directories will be
  41.     automatically created, and files will be deposited in them: 
  42.  
  43.     a.  A 'src' directory, which will contain general *.c files.
  44.     b.  An 'include' directory, which will contain general *.h files.
  45.     c.  An 'auxil' directory, which will contain a variety of data files.
  46.     d.  An 'amiga' directory, which will contain the Amiga-specific files.
  47.     e.  An 'others' directory, which will contain MSDOS and TOS files.
  48.     f.  A 'vms' directory, which will contain VMS files.
  49.     g.  A 'mac' directory, which will contain Macintosh files.
  50.  
  51.     The names of these directories should not be changed, unless you are
  52.     ready to go through the makefiles and the makedefs program and change
  53.     all the directory references in them.
  54.  
  55. 3.  Having unpacked, you should have a file called 'Files' in your Top
  56.     directory.  This file contains the list of all the files you now SHOULD 
  57.     have in each directory.  Please check the files in each directory 
  58.     against this list to make sure that you have a complete set.
  59.  
  60. 4.  Before you do anything else, please read carefully the file called
  61.     'license' in the auxil subdirectory.  It is expected that you comply
  62.     with the terms of that license, and we are very serious about it.  In
  63.     particular, you are prohibited by the terms of the license from using
  64.     NetHack 3.0 for gainful purposes.   
  65.  
  66. 5.  If everything is in order, you can now turn to trying to get the program
  67.     to compile and run on your particular system.  It is worth mentioning
  68.     that the default configuration is Ultrix (simply because the code was
  69.     housed on such a system).  It is also worth mentioning here that NetHack
  70.     3.0 is a huge program by comparison with 2.3.  If you intend to run it
  71.     on a small machine, you'll have to make hard choices among the options
  72.     available in config.h.
  73.  
  74.     The files Install.* were written to guide you in configuring the program
  75.     for your operating system.  Reading them, and the man page, should answer
  76.     most of your questions.
  77.  
  78.     At the time of this release, NetHack 3.0 is known to run on:
  79.  
  80.         DEC vaxen running Ultrix and BSD
  81.         Sun-3s running SunOS 4.0
  82.         Encore Multimax running UMAX 4.2
  83.         Bull XPS100 running System V R2.2 or R3.1
  84.         Bull DPX/2 200 running System V R3.1
  85.         AT&T 3B4000 running System V
  86.         AT&T 3B1 running System V (3.51)
  87.         AT&T 3B2/600 & 3B2/622 running System V R3.2.1
  88.         AT&T 3B2/1000 Model 80 running System V R3.2.2
  89.         286 box running Microport SysV/AT (not extensively tested)
  90.         IBM PC compatibles running MicroSoft C or Turbo C under MS-DOS
  91.         IBM PS/2 and AT compatibles running MicroSoft C under OS/2
  92.         Commodore Amiga running Lattice or Manx/Aztec C under
  93.         AmigaDOS 1.3 (WorkBench 1.3, KickStart 1.2 or 1.3)
  94.         Atari 1040ST under TOS
  95.         DEC vaxen running VMS
  96.         Data General AViiON systems under DG/UX
  97.         Valid Logic Systems SCALD-System
  98.         Macintosh (still requires testing)
  99.         Mips M2000 running RiscOS 4.1
  100.         Gould NP1 running UTX 3/2
  101.         Stride 460 running UniStride 2.1
  102.         Pyramid 9820x running OSx 4.4c
  103.  
  104.             - - - - - - - - - - -
  105.  
  106. If you have problems building the game, or you find bugs in it, the 
  107. development team may be reached as
  108.  
  109.             nethack-bugs@linc.cis.upenn.edu.  
  110.  
  111. Patches especially should be directed to this address.  If you've changed 
  112. something to get NetHack to run on your system, it's likely that others have
  113. done it by making slightly different modifications.  By routing your patches
  114. through the development team, we should be able to avoid making everyone else
  115. choose among variant patches claiming to do the same thing, to keep most of
  116. the copies of 3.0 synchronized by means of official patches, and to maintain
  117. the painfully-created file organization.  (Remember the mess when everybody
  118. just posted their own patches to 2.3?  There were no archived bug-fixes to
  119. give people who got 2.3 after its initial release, so the same bugs kept being
  120. discovered by new batches of people.  Please cooperate to keep this from
  121. happening to 3.0.)
  122.  
  123. It is inevitable that we will reject some proposed additions of new features
  124. either because they do not fit our conception of the game, or because they 
  125. require more code than we consider they're worth.  If we reject your feature,
  126. you are free, of course, to post the patches to the net yourself and let the
  127. marketplace decide its worth.
  128.  
  129. All of this amounts to the following:  If you decide to apply a free-lanced
  130. patch to your 3.0 code, you are on your own.  In our own patches, including
  131. those which will update to 3.1, we will assume that your code is synchronized
  132. with ours.
  133.  
  134.           -- Good luck, and happy Hacking --
  135.  
  136.