home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 100 / 87 / hack.doc < prev    next >
Text File  |  1985-05-08  |  9KB  |  219 lines
  1.              HACK version 1.0.1 for MSDOS computers
  2.              --------------------------------------
  3.  
  4.                         by Don Kneller
  5.  
  6.  
  7. Background
  8. ----------
  9.  
  10.      HACK is a display oriented dungeons and dragons type game.  It
  11. is similar in style to ROGUE played on UNIX systems but HACK is much
  12. richer in character.  HACK has many more monsters and highly varied magic.
  13.  
  14.      HACK was originally written for UNIX systems by several people at
  15. the Stichting Mathematisch Centrum in Amsterdam and I have converted
  16. it to run under MSDOS 2.x and above.  For all those who have played HACK
  17. on UNIX, this is a complete version 1.0.1 except that engravings are not
  18. implemented.  I had to remove something to stay under a target of 256K ram.
  19.  
  20.      Save games are fully implemented and are machine independent.  Also
  21. implemented are some of the features of HACK 1.0.2 which I had already added
  22. because they were in ROGUE.  In particular there is a discover command (\)
  23. to tell you about objects you know something about.  Also, there is MORE
  24. processing on long inventories.
  25.  
  26.      HACK uses the terminal independence package (TIP) from LATTICE and
  27. is very fast at screen I/O.  TIP is much, much faster than the ANSI driver
  28. and is about as portable.
  29.  
  30.  
  31.  
  32. System requirements
  33. -------------------
  34.  
  35.      To play HACK you need the following:
  36.  
  37.      1 - MSDOS computer running MSDOS (or PCDOS) 2.0 or greater
  38.           I have tested HACK on the following systems and it runs without
  39.           a hitch:
  40.                IBM AT (80286) with lots of memory, a hard disk, and
  41.                     the enhanced graphics display.
  42.                IBM PC with 256K and 2 floppies or hard disk
  43.                     - monochrome monitor and monochrome display card
  44.                     - color monitor and card (sorry, HACK doesn't uses color)
  45.                     - monochrome monitor and Hercules card.
  46.                ATT 6300 with 256K and a hard disk.
  47.                Columbia PC with 256K and 2 floppies.
  48.                Compaq portable with 256K and 2 floppies.
  49.                Compaq Deskpro (8086) with 512K and a hard disk.
  50.                ITT XTRA with 256K and 2 floppies.
  51.                Tandy 1200 with 256K and a hard disk.
  52.  
  53.           It will probably also run on other MSDOS systems like the Tandy
  54.           2000 (80186) and 1000 but I haven't tested it yet because I
  55.           couldn't find these with sufficient memory.
  56.           
  57.      256K ram
  58.           You need about 230,000 bytes of free ram.  Use chkdsk to find out
  59.           if you have enough.  I tried HACK on a Tandy 2000 with 256K and
  60.           MSDOS but it wouldn't run because the Tandy had only 210,000 bytes
  61.           of free memory.  Under MSDOS 2.0 I have about 233,000 bytes free.
  62.  
  63.      2 - 360K floppies or a hard disk
  64.           In principle you could use one 360K floppy but you would not be
  65.           able to save and restore big games (big in the sense that the longer
  66.           you are alive in the game, the more disk storage is used.  Thus, the
  67.           big games are also the good games).
  68.  
  69.  
  70. Configuration of HACK for your MSDOS computer.
  71. ----------------------------------------------
  72.      The configuration of HACK is controlled by environment variables.
  73. At the system prompt type:
  74.  
  75.      A>set VAR=VALUE
  76. This sets the value of the environment variable VAR to VALUE.  See the
  77. PCDOS 2.0 manual page 10-21 for details.
  78.  
  79. The variables used by HACK are:
  80.  
  81.      HACK      This is your name in the game.
  82.                     ex:            Blue Meanie (or other nonsense name)
  83.                     default value: none
  84.  
  85.      HACKDIR   This is the PATH to where the support files (rumors, data,
  86.                help, and record) are found.  I use a HACKDIR in case
  87.                you have HACK.EXE on your executable path and you want the
  88.                support files somewhere else.
  89.                     ex:            C:\games\hack\
  90.                     default value: .\          (the current directory)
  91.                
  92.                IMPORTANT:  This is a directory PATH and should end with
  93.                     the '\' character.
  94.  
  95.      HACKLEVELS  This the PATH where the program will generate its
  96.                temporary level files.  As well, this is where some
  97.                of the level files get left as bones files (you will
  98.                understand bones when you start playing).
  99.                     ex:            C:\games\hack\levels\
  100.                     default value: B:\
  101.  
  102.                IMPORTANT:  This is a directory PATH and should end with
  103.                     the '\' character.
  104.                          
  105.      HACKSAVE  This is the full name of the savefile (including any path)
  106.                for saving and restoring incomplete games.
  107.                     ex:            C:\games\hack\hack.sav
  108.                     default value: .\hack.sav
  109.  
  110.                If you append ";noprompt" or just ";n" to the name of the
  111.                savefile, the program won't prompt you to insert the diskette
  112.                used for saving.  This is useful if you have a hard disk.
  113.                     ex:            C:\games\hack\hack.sav;n
  114.  
  115.      Of course, using a batch file to set the environment variables is
  116. easier than typing them in each time you want to play.
  117.  
  118.  
  119. Sample configurations
  120. ---------------------
  121.      All configurations should specify a value for the environment variable
  122. HACK.  If you don't, your name in the game will be Nick Danger (a shadowy
  123. rapscallion known for dirty deeds and skullduggery).
  124.  
  125.      Two floppy systems:
  126.           The default values should be fine.  They are:
  127.                HACKDIR = .\
  128.                HACKLEVELS = B:\
  129.                HACKSAVE = .\hack.sav
  130.           If you make a bootable disk (ie using format /s) and put hack.exe
  131.           and its support files on it, then use it in drive A whenever you
  132.           want to play hack.  The savefile will then also be on drive A (the
  133.           default drive) and the level files will be on drive B.  You
  134.           will be prompted to put in the disk with the savefile on it at
  135.           the appropriate moments.
  136.                Due to the large size of files that hack uses, I implore you
  137.           to use separate floppies for hack.exe (and support files), for the
  138.           levels, and for a save disk.  Start with:
  139.                GAME DISK:     command.com
  140.                               hack.exe
  141.                               rumors
  142.                               data
  143.                               help
  144.                               others (autoexec.bat, config.sys, etc)
  145.                LEVEL DISK:    empty
  146.                SAVE DISK:     empty
  147.  
  148.  
  149.      Hard disk system:
  150.           You might try:
  151.                HACKLEVELS = C:\games\hack\
  152.                HACKDIR = C:\games\hack\          (put the support files in here)
  153.                HACKSAVE = C:\games\hack\hack.sav;n     (no prompting required)
  154.           You can put hack.exe anywhere, preferable on your executables path so
  155.           you don't have to change directories to play.
  156.           
  157.  
  158.  
  159. How to play HACK
  160. ----------------
  161.  
  162.      UNPACKING
  163.      ---------
  164.      The files hack.exe and support files are in LU format in HACK.LBR.
  165.      Unpack the files with LU86403 then use NUSQ101 to uncompress them.
  166.  
  167.      PLAYING
  168.      -------
  169.      HACK has two command line options: -u and -s.
  170.  
  171.      -u name          Specifies the name to use other than the value of the
  172.                HACK environment variable.
  173.  
  174.      ex: A> hack -uTerminator
  175.      or  A> hack -u Terminator
  176.  
  177.      You can append -c, -w, -s, -f, -k, or -t to the name to select the
  178.      type of character you want to be.
  179.      ex: A> hack -uTerminator-c
  180.  
  181.      This means you will play with the name Terminator and you will be a
  182.      Cave-man (person).
  183.  
  184.  
  185.      -s [name]     Means to list the scores of the person with this name.
  186.                    If the name is not given, uses the value of the HACK
  187.                    environment variable.
  188.  
  189.      Once you have started hack, type a ? to get help on the available
  190. commands.  You can also print the help file and keep it for a handy reference.
  191.  
  192.  
  193. Pitch
  194. -----
  195.      In order not to get bad karma you should rush out with all haste
  196. and send $$$ to:
  197.                Don Kneller
  198.                2 Panoramic Way #204
  199.                Berkeley, CA 94704
  200.  
  201.  
  202. Even if you don't send $$$, you are encouraged to copy this program and
  203. give it to your friends and post it to BBS's.  You can send me mail on
  204. the Walnut Creek, CA BBS at (415) 937-0156.  For people on the network
  205. you can get in touch with me at:
  206.  
  207.                  ucbvax!ucsfcgl!kneller
  208.           -or-
  209.                  kneller@ucsf-cgl.ARPA
  210.  
  211. We have been playing HACK on an IBM PC for about 3 weeks now and seem to
  212. have the bugs worked out.  If you find a bug, please let me know at any
  213. of the above 4 locations.
  214.  
  215. Your contribution would be much appreciated and provide encouragement to
  216. update to version 1.0.2 of HACK.   Whether you contribute or not,
  217.  
  218.      Happy Hacking!!!!!!!
  219.