games/hack/hack.6

   1 .\" $FreeBSD: src/games/hack/hack.6,v 1.2.8.1 2001/07/22 11:01:22 dd Exp $
   2 .\" $DragonFly: src/games/hack/hack.6,v 1.2 2003/06/17 04:25:24 dillon Exp $
   3 .TH HACK 6 "31 March 1985"
   4 .UC 4
   5 .SH NAME
   6 hack \- exploring The Dungeons of Doom
   7 .SH SYNOPSIS
   8 .B /usr/games/hack
   9 [
  10 .B \-d
  11 .I directory
  12 ]
  13 [
  14 .B \-n
  15 ]
  16 [
  17 .B \-u
  18 .I playername
  19 ]
  20 .br
  21 .B /usr/games/hack
  22 [
  23 .B \-d
  24 .I directory
  25 ]
  26 .B \-s
  27 [
  28 .B \-X
  29 ]
  30 [
  31 .I playernames
  32 ]
  33 .SH DESCRIPTION
  34 .I Hack
  35 is a display oriented dungeons & dragons - like game.
  36 Both display and command structure resemble rogue.
  37 (For a game with the same structure but entirely different display -
  38 a real cave instead of dull rectangles - try Quest.)
  39 .PP
  40 To get started you really only need to know two commands.  The command
  41 .B ?
  42 will give you a list of the available commands and the command
  43 .B /
  44 will identify the things you see on the screen.
  45 .PP
  46 To win the game (as opposed to merely playing to beat other people high
  47 scores) you must locate the Amulet of Yendor which is somewhere below
  48 the 20th level of the dungeon and get it out.  Nobody has achieved this
  49 yet and if somebody does, he will probably go down in history as a hero
  50 among heroes.
  51 .PP
  52 When the game ends, either by your death, when you quit, or if you escape
  53 from the caves,
  54 .I hack
  55 will give you (a fragment of) the list of top scorers.  The scoring
  56 is based on many aspects of your behavior but a rough estimate is
  57 obtained by taking the amount of gold you've found in the cave plus four
  58 times your (real) experience. Precious stones may be worth a lot of gold
  59 when brought to the exit.
  60 There is a 10% penalty for getting yourself killed.
  61 .PP
  62 The administration of the game is kept in the directory specified with the
  63 .B \-d
  64 option, or, if no such option is given, in the directory specified by
  65 the environment variable HACKDIR, or, if no such variable exists, in
  66 the current directory. This same directory contains several auxiliary
  67 files such as lockfiles and the list of top scorers and a subdirectory
  68 .I save
  69 where games are saved.
  70 The game administrator may however choose to install hack with a fixed
  71 playing ground, usually /usr/games/lib/hackdir.
  72 .PP
  73 The
  74 .B \-n
  75 option suppresses printing of the news.
  76 .PP
  77 The
  78 .B \-u
  79 .I playername
  80 option supplies the answer to the question "Who are you?".
  81 When
  82 .I playername
  83 has as suffix one of
  84 .B \-T \-S \-K \-F \-C \-W
  85 then this supplies the answer to the question "What kind of character ... ?".
  86 .PP
  87 The
  88 .B \-s
  89 option will print out the list of your scores. It may be followed by arguments
  90 .B \-X
  91 where X is one of the letters C, F, K, S, T, W to print the scores of
  92 Cavemen, Fighters, Knights, Speleologists, Tourists or Wizards.
  93 It may also be followed by one or more player names to print the scores of the
  94 players mentioned.
  95 .SH AUTHORS
  96 Jay Fenlason (+ Kenny Woodland, Mike Thome and Jon Payne) wrote the
  97 original hack, very much like rogue (but full of bugs).
  98 .br
  99 Andries Brouwer continuously deformed their sources into the current
 100 version - in fact an entirely different game.
 101 .SH FILES
 102 .DT
 103 .ta \w'data, rumors\ \ \ 'u
 104 hack    The hack program.
 105 .br
 106 data, rumors    Data files used by hack.
 107 .br
 108 help, hh        Help data files.
 109 .br
 110 record  The list of top scorers.
 111 .br
 112 save    A subdirectory containing the saved
 113 .br
 114         games.
 115 .br
 116 bones_dd        Descriptions of the ghost and
 117 .br
 118         belongings of a deceased adventurer.
 119 .br
 120 xlock.dd        Description of a dungeon level.
 121 .br
 122 safelock        Lock file for xlock.
 123 .br
 124 record_lock     Lock file for record.
 125 .SH ENVIRONMENT
 126 .DT
 127 .ta \w'HACKPAGER, PAGER\ \ \ 'u
 128 USER or LOGNAME Your login name.
 129 .br
 130 HOME            Your home directory.
 131 .br
 132 SHELL           Your shell.
 133 .br
 134 TERM            The type of your terminal.
 135 .br
 136 HACKPAGER, PAGER        Pager used instead of default pager.
 137 .br
 138 MAIL    Mailbox file.
 139 .br
 140 MAILREADER      Reader used instead of default.
 141 .br
 142 HACKDIR Playground.
 143 .br
 144 HACKOPTIONS     String predefining several hack options
 145 .br
 146         (see help file).
 147 .br
 148
 149 Several other environment variables are used in debugging (wizard) mode,
 150 like GENOCIDED, INVENT, MAGIC and SHOPTYPE.
 151 .SH BUGS
 152 Probably infinite.
 153 Mail complaints to mcvax!aeb .