hack/hack.6

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