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