games/hack/hack.6

   1 .\"     $NetBSD: hack.6,v 1.15 2005/09/15 02:09:41 wiz Exp $    -*- nroff -*-
   2 .\"
   3 .\" Copyright (c) 1985, Stichting Centrum voor Wiskunde en Informatica,
   4 .\" Amsterdam
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions are
   9 .\" met:
  10 .\"
  11 .\" - Redistributions of source code must retain the above copyright notice,
  12 .\" this list of conditions and the following disclaimer.
  13 .\"
  14 .\" - Redistributions in binary form must reproduce the above copyright
  15 .\" notice, this list of conditions and the following disclaimer in the
  16 .\" documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" - Neither the name of the Stichting Centrum voor Wiskunde en
  19 .\" Informatica, nor the names of its contributors may be used to endorse or
  20 .\" promote products derived from this software without specific prior
  21 .\" written permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
  24 .\" IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  25 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  26 .\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
  27 .\" OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  28 .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  29 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  30 .\" PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  31 .\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  32 .\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  33 .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34 .\"
  35 .\"
  36 .\" Copyright (c) 1982 Jay Fenlason <hack@gnu.org>
  37 .\" All rights reserved.
  38 .\"
  39 .\" Redistribution and use in source and binary forms, with or without
  40 .\" modification, are permitted provided that the following conditions
  41 .\" are met:
  42 .\" 1. Redistributions of source code must retain the above copyright
  43 .\"    notice, this list of conditions and the following disclaimer.
  44 .\" 2. Redistributions in binary form must reproduce the above copyright
  45 .\"    notice, this list of conditions and the following disclaimer in the
  46 .\"    documentation and/or other materials provided with the distribution.
  47 .\" 3. The name of the author may not be used to endorse or promote products
  48 .\"    derived from this software without specific prior written permission.
  49 .\"
  50 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
  51 .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  52 .\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
  53 .\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  54 .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  55 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  56 .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  57 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  58 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  59 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  60 .\"
  61 .Dd March 31, 1985
  62 .Dt HACK 6
  63 .Os
  64 .Sh NAME
  65 .Nm hack
  66 .Nd exploring The Dungeons of Doom
  67 .Sh SYNOPSIS
  68 .Nm
  69 .Op Fl d Ar directory
  70 .Op Fl n
  71 .Op Fl u Ar playername
  72 .Nm
  73 .Op Fl d Ar directory
  74 .Op Fl s
  75 .Op Fl X
  76 .Op Ar playername ...
  77 .Sh DESCRIPTION
  78 .Nm
  79 is a display oriented dungeons \*[Am] dragons-like game.
  80 Both display and command structure resemble rogue.
  81 (For a game with the same structure but entirely different display -
  82 a real cave instead of dull rectangles - try Quest.)
  83 .Pp
  84 To get started you really only need to know two commands.
  85 The command
  86 .Ic \&?
  87 will give you a list of the available commands and the command
  88 .Ic /
  89 will identify the things you see on the screen.
  90 .Pp
  91 To win the game (as opposed to merely playing to beat other people's high
  92 scores) you must locate the Amulet of Yendor which is somewhere below
  93 the 20th level of the dungeon and get it out.
  94 Nobody has achieved this yet and if somebody does, he will probably go
  95 down in history as a hero among heroes.
  96 .Pp
  97 When the game ends, either by your death, when you quit, or if you escape
  98 from the caves,
  99 .Nm
 100 will give you (a fragment of) the list of top scorers.
 101 The scoring is based on many aspects of your behavior but a rough estimate
 102 is obtained by taking the amount of gold you've found in the cave plus four
 103 times your (real) experience.
 104 Precious stones may be worth a lot of gold when brought to the exit.
 105 There is a 10% penalty for getting yourself killed.
 106 .Pp
 107 The administration of the game is kept in the directory specified with the
 108 .Fl d
 109 option, or, if no such option is given, in the directory specified by
 110 the environment variable
 111 .Ev HACKDIR ,
 112 or, if no such variable exists, in the current directory.
 113 This same directory contains several auxiliary files such as lockfiles and
 114 the list of topscorers and a subdirectory
 115 .Pa save
 116 where games are saved.
 117 The game administrator may however choose to install
 118 .Nm
 119 with a fixed playing ground, usually
 120 .Pa /var/games/hackdir .
 121 .Pp
 122 The
 123 .Fl n
 124 option suppresses printing of the news.
 125 .Pp
 126 The
 127 .Fl u Ar playername
 128 option supplies the answer to the question "Who are you?".
 129 When
 130 .Ar playername
 131 has as suffix one of
 132 .Em -T ,
 133 .Em -S ,
 134 .Em -K ,
 135 .Em -F ,
 136 .Em -C ,
 137 or
 138 .Em -W ,
 139 then this supplies the answer to the question "What kind of character ... ?".
 140 .Pp
 141 The
 142 .Fl s
 143 option will print out the list of your scores.
 144 It may be followed by arguments
 145 .Fl X
 146 where X is one of the letters C, F, K, S, T, W to print the scores of
 147 Cavemen, Fighters, Knights, Speleologists, Tourists or Wizards.
 148 It may also be followed by one or more player names to print the scores of the
 149 players mentioned.
 150 .Sh ENVIRONMENT
 151 .Bl -tag -width 24n -compact
 152 .It Ev USER No or Ev LOGNAME
 153 Your login name.
 154 .It Ev HOME
 155 Your home directory.
 156 .It Ev SHELL
 157 Your shell.
 158 .It Ev TERM
 159 The type of your terminal.
 160 .It Ev HACKPAGER, PAGER
 161 Pager used instead of default pager.
 162 .It Ev MAIL
 163 Mailbox file.
 164 .It Ev MAILREADER
 165 Reader used instead of default (probably
 166 .Pa /usr/bin/mail ) .
 167 .It Ev HACKDIR
 168 Playground.
 169 .It Ev HACKOPTIONS
 170 String predefining several
 171 .Nm
 172 options (see help file).
 173 .El
 174 .Pp
 175 Several other environment variables are used in debugging (wizard) mode,
 176 like
 177 .Ev GENOCIDED ,
 178 .Ev INVENT ,
 179 .Ev MAGIC
 180 and
 181 .Ev SHOPTYPE .
 182 .Sh FILES
 183 .Bl -tag -width 24n -compact
 184 .It Pa hack
 185 The
 186 .Nm
 187 program.
 188 .It Pa data, rumors
 189 Data files used by
 190 .Nm .
 191 .It Pa help, hh
 192 Help data files.
 193 .It Pa record
 194 The list of topscorers.
 195 .It Pa save
 196 A subdirectory containing the saved games.
 197 .It Pa bones_dd
 198 Descriptions of the ghost and belongings of a deceased adventurer.
 199 .It Pa xlock.dd
 200 Description of a dungeon level.
 201 .It Pa safelock
 202 Lock file for xlock.
 203 .It Pa record_lock
 204 Lock file for record.
 205 .El
 206 .Sh AUTHORS
 207 .An -nosplit
 208 .An Jay Fenlason
 209 (+
 210 .An Kenny Woodland ,
 211 .An Mike Thome
 212 and
 213 .An Jon Payne )
 214 wrote the original
 215 .Nm ,
 216 very much like
 217 .Xr rogue 6
 218 (but full of bugs).
 219 .Pp
 220 .An Andries Brouwer
 221 continuously deformed their sources into the current
 222 version - in fact an entirely different game.
 223 .Sh BUGS
 224 Probably infinite.
 225 Mail complaints to mcvax!aeb .