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