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 79is a display oriented dungeons \*[Am] dragons-like game. 80Both display and command structure resemble rogue. 81(For a game with the same structure but entirely different display - 82a real cave instead of dull rectangles - try Quest.) 83.Pp 84To get started you really only need to know two commands. 85The command 86.Ic \&? 87will give you a list of the available commands and the command 88.Ic / 89will identify the things you see on the screen. 90.Pp 91To win the game (as opposed to merely playing to beat other people's high 92scores) you must locate the Amulet of Yendor which is somewhere below 93the 20th level of the dungeon and get it out. 94Nobody has achieved this yet and if somebody does, he will probably go 95down in history as a hero among heroes. 96.Pp 97When the game ends, either by your death, when you quit, or if you escape 98from the caves, 99.Nm 100will give you (a fragment of) the list of top scorers. 101The scoring is based on many aspects of your behavior but a rough estimate 102is obtained by taking the amount of gold you've found in the cave plus four 103times your (real) experience. 104Precious stones may be worth a lot of gold when brought to the exit. 105There is a 10% penalty for getting yourself killed. 106.Pp 107The administration of the game is kept in the directory specified with the 108.Fl d 109option, or, if no such option is given, in the directory specified by 110the environment variable 111.Ev HACKDIR , 112or, if no such variable exists, in the current directory. 113This same directory contains several auxiliary files such as lockfiles and 114the list of topscorers and a subdirectory 115.Pa save 116where games are saved. 117The game administrator may however choose to install 118.Nm 119with a fixed playing ground, usually 120.Pa /var/games/hackdir . 121.Pp 122The 123.Fl n 124option suppresses printing of the news. 125.Pp 126The 127.Fl u Ar playername 128option supplies the answer to the question "Who are you?". 129When 130.Ar playername 131has as suffix one of 132.Em -T , 133.Em -S , 134.Em -K , 135.Em -F , 136.Em -C , 137or 138.Em -W , 139then this supplies the answer to the question "What kind of character ... ?". 140.Pp 141The 142.Fl s 143option will print out the list of your scores. 144It may be followed by arguments 145.Fl X 146where X is one of the letters C, F, K, S, T, W to print the scores of 147Cavemen, Fighters, Knights, Speleologists, Tourists or Wizards. 148It may also be followed by one or more player names to print the scores of the 149players mentioned. 150.Sh ENVIRONMENT 151.Bl -tag -width 24n -compact 152.It Ev USER No or Ev LOGNAME 153Your login name. 154.It Ev HOME 155Your home directory. 156.It Ev SHELL 157Your shell. 158.It Ev TERM 159The type of your terminal. 160.It Ev HACKPAGER, PAGER 161Pager used instead of default pager. 162.It Ev MAIL 163Mailbox file. 164.It Ev MAILREADER 165Reader used instead of default (probably 166.Pa /usr/bin/mail ) . 167.It Ev HACKDIR 168Playground. 169.It Ev HACKOPTIONS 170String predefining several 171.Nm 172options (see help file). 173.El 174.Pp 175Several other environment variables are used in debugging (wizard) mode, 176like 177.Ev GENOCIDED , 178.Ev INVENT , 179.Ev MAGIC 180and 181.Ev SHOPTYPE . 182.Sh FILES 183.Bl -tag -width 24n -compact 184.It Pa hack 185The 186.Nm 187program. 188.It Pa data, rumors 189Data files used by 190.Nm . 191.It Pa help, hh 192Help data files. 193.It Pa record 194The list of topscorers. 195.It Pa save 196A subdirectory containing the saved games. 197.It Pa bones_dd 198Descriptions of the ghost and belongings of a deceased adventurer. 199.It Pa xlock.dd 200Description of a dungeon level. 201.It Pa safelock 202Lock file for xlock. 203.It Pa record_lock 204Lock file for record. 205.El 206.Sh AUTHORS 207.An -nosplit 208.An Jay Fenlason 209(+ 210.An Kenny Woodland , 211.An Mike Thome 212and 213.An Jon Payne ) 214wrote the original 215.Nm , 216very much like 217.Xr rogue 6 218(but full of bugs). 219.Pp 220.An Andries Brouwer 221continuously deformed their sources into the current 222version - in fact an entirely different game. 223.Sh BUGS 224Probably infinite. 225Mail complaints to mcvax!aeb . 226