resolve mandoc(1) warnings in games/
[dragonfly.git] / games / hunt / hunt / hunt.6
CommitLineData
82a5c12e
MD
1.\" $NetBSD: hunt.6,v 1.3 1997/10/10 16:32:30 lukem Exp $
2.\" $OpenBSD: hunt.6,v 1.19 2007/05/31 19:19:17 jmc Exp $
82a5c12e
MD
3.\"
4.\" Copyright (c) 1985 Conrad C. Huang, Gregory S. Couch, Kenneth C.R.C. Arnold
5.\" San Francisco, California
6.\"
7.\" Copyright (c) 1985 Regents of the University of California.
8.\" All rights reserved.
9.\"
10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions
12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright
14.\" notice, this list of conditions and the following disclaimer.
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\" notice, this list of conditions and the following disclaimer in the
17.\" documentation and/or other materials provided with the distribution.
18.\" 3. Neither the name of the University nor the names of its contributors
19.\" may be used to endorse or promote products derived from this software
20.\" without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
95f13fdd 34.Dd September 2, 2008
82a5c12e
MD
35.Dt HUNT 6
36.Os
37.Sh NAME
38.Nm hunt
39.Nd a multi-player multi-terminal game
40.Sh SYNOPSIS
95f13fdd 41.Nm
82a5c12e
MD
42.Op Fl bcfmqSs
43.Op Fl n Ar name
44.Op Fl p Ar port
45.Op Fl t Ar team
46.Op Fl w Ar message
47.Oo
48.Op Fl h
49.Ar host
50.Oc
51.Sh DESCRIPTION
52The object of the game
53.Nm
54is to kill off the other players.
55There are no rooms, no treasures, and no monsters.
56Instead, you wander around a maze, find grenades, trip mines, and shoot down
57walls and players.
58The more players you kill before you die, the better your score is.
59If the
60.Fl m
61flag is given,
62you enter the game as a monitor
63.Po
64you can see the action but you cannot play
65.Pc .
66.Pp
67.Nm
68looks for an active game on the local network.
69The location of the game may be specified by giving the
70.Ar host
71argument.
72This presupposes that a hunt game is already running on that host: see
73.Xr huntd 6
74for details on how to set up a game on a specific host.
75If more than one game is found, you may pick which game to play in.
76If no games are found,
77.Nm
78will exit.
79.Pp
80If the
81.Fl q
82flag is given,
83.Nm
84queries the local network
85.Pq or specific host
86and reports on all active games found.
87This is useful for shell startup scripts, e.g., csh's
88.Pa .login .
89.Pp
90The player name may be specified on the command line by using the
91.Fl n
92option.
93.Pp
94The
95.Fl c ,
96.Fl s ,
97and
98.Fl f
99options are for entering the game cloaked, scanning, or flying, respectively.
100.Pp
101The
102.Fl b
103option turns off beeping when you reach the typeahead limit.
104.Pp
105The
106.Fl t
107option aids team play by making everyone else on your team
108appear as the team name.
109A team name is a single digit to avoid conflicting with other characters
110used in the game.
111Use a team name consisting of a single space
112.Pq Sq \
113to remain on your own.
114.Pp
115The
116.Fl p
117.Ar port
118option allows the rendezvous port number to be set.
119.Pp
120The
121.Fl w
122.Ar message
123option is the only way to send a message to everyone else's screen when
124you start up.
125It is most often used to say
126.Dq eat slime death - NickD's coming in .
127.Pp
128When you die and are asked if you wish to re-enter the game,
129there are other answers than just yes or no.
130You can also reply with a
131.Ic w
132to write a message before continuing or
133.Ic o
134to change how you enter the game
135.Pq cloaked, scanning, or flying .
136.Sh "PLAYING HINTS"
137.Nm
138only works on terminals with at least 24 lines, 80 columns, and
139cursor addressing.
86a8591e 140The screen is divided into 3 areas.
82a5c12e
MD
141On the right hand side is the status area.
142It shows damage sustained,
143charges remaining,
144who's in the game,
145who's scanning
146.Po
147the
148.Ql \&*
149in front of the name
150.Pc ,
151who's cloaked
152.Po
153the
154.Ql \&+
155in front of the name
156.Pc ,
157and other players' scores.
158The rest of the screen is taken up by your map of the maze.
159The 24th line
160is used for longer messages that don't fit in the status area.
161.Pp
162.Nm
163uses the same keys to move as
164.Xr vi 1
165does, i.e.,
166.Ic h ,
167.Ic j ,
168.Ic k ,
169and
170.Ic l
171for left, down, up, right, respectively.
172To change which direction you're facing in the maze,
173use the upper case version of the movement key
174.Po
175i.e.,
176.Ic HJKL
177.Pc .
178You can only fire or throw things in the direction you're facing.
179.Pp
180Other commands are:
181.Bl -tag -width Ic -compact
182.It Ic f No or Ic 1
183Fire a bullet
184.Pq Takes 1 charge
185.It Ic g No or Ic 2
186Throw grenade
187.Pq Takes 9 charges
188.It Ic F No or Ic 3
189Throw satchel charge
190.Pq Takes 25 charges
191.It Ic G No or Ic 4
192Throw bomb
193.Pq Takes 49 charges
194.It Ic 5
195Throw big bomb
196.Pq Takes 81 charges
197.It Ic 6
198Throw even bigger bomb
199.Pq Takes 121 charges
200.It Ic 7
201Throw even more big bomb
202.Pq Takes 169 charges
203.It Ic 8
204Throw even more bigger bomb
205.Pq Takes 225 charges
206.It Ic 9
207Throw very big bomb
208.Pq Takes 289 charges
209.It Ic 0
210Throw very, very big bomb
211.Pq Takes 361 charges
212.It Ic @
213Throw biggest bomb
214.Pq Takes 441 charges
215.It Ic o
216Throw small slime
217.Pq Takes 5 charges
218.It Ic O
219Throw big slime
220.Pq Takes 10 charges
221.It Ic p
222Throw bigger slime
223.Pq Takes 15 charges
224.It Ic P
225Throw biggest slime
226.Pq Takes 20 charges
227.It Ic s
228Scan
229.Pq show where other players are
230.Pq Takes 1 charge
231.It Ic c
232Cloak
233.Pq hide from scanners
234.Pq Takes 1 charge
235.It Ic ^L
236Redraw screen
237.It Ic q
238Quit
239.El
240.Pp
241The symbols on the screen are:
242.Bl -tag -width Ic -compact
243.It Li \&- \&| \&+
244walls
245.It Li \&/ \e
246diagonal
247.Pq deflecting
248walls
249.It Li #
250doors
251.Pq dispersion walls
1b5b166a 252.It Li \&;
82a5c12e
MD
253small mine
254.It Li g
255large mine
1b5b166a 256.It Li \&:
82a5c12e
MD
257bullet
258.It Li o
259grenade
260.It Li O
261satchel charge
262.It Li @
263bomb
264.It Li s
265small slime
266.It Li $
267big slime
268.It Li > < ^ v
269you, facing right, left, up, or down
270.It Li } { i \&!
271other players facing right, left, up, or down
272.It \&*
273explosion
274.It Li \&\e|/
275.It Li \&-*-
276grenade and large mine explosion
277.It Li \&/|\e
278.El
279.Pp
280Other helpful hints:
281.Bl -bullet -compact
282.It
283You can only fire in the direction you are facing.
284.It
285You can only fire three shots in a row before the gun must cool off.
286.It
287Shots move 5 times faster than you do.
288.It
289To stab someone,
290you face that player and move at them.
291.It
292Stabbing does 2 points worth of damage and shooting does 5 points.
293.It
294Slime does 5 points of damage each time it hits.
295.It
296You start with 15 charges and get 5 more every time a player enters
297or re-enters.
298.It
299Grenade explosions cover a 3 by 3 area, each larger bomb cover a
300correspondingly larger area
301.Po
302ranging from 5 by 5 to 21 by 21
303.Pc .
304All explosions are centered around the square the shot hits and
305do the most damage in the center.
306.It
307Slime affects all squares it oozes over.
308The number of squares is equal to the number of charges used,
309multiplied by
310.Va slimefactor
311as set by
312.Xr huntd 6
313.Pq default 3 .
314.It
315One small mine and one large mine are placed in the maze for every new player.
316A mine has a 2% probability of tripping when you walk forward on to it;
31750% when going sideways;
31895% when backing up.
319Tripping a mine costs you 5 points or 10 points, respectively.
320Defusing a mine is worth 1 charge or 9 charges, respectively.
321.It
322You cannot see behind you.
323.It
324Cloaking consumes 1 ammo charge per 20 of your moves.
325.It
326Scanning consumes 1 ammo charge per (20 \(mu the number of players)
327of other player moves.
328.It
329Turning on cloaking turns off scanning \(em turning on scanning turns off
330cloaking.
331.It
332When you kill someone,
333you get 2 more damage capacity points and 2 damage points get taken away.
334.It
335Maximum typeahead is 5 characters.
336.It
337A shot destroys normal
338.Pq i.e., non-diagonal, non-door
339walls.
340.It
341Diagonal walls deflect shots and change orientation.
342.It
343Doors disperse shots in random directions
344.Pq up, down, left, right .
345.It
346Diagonal walls and doors cannot be destroyed by direct shots but may
347be destroyed by an adjacent grenade explosion.
348.It
349Slime goes around walls, not through them.
350.It
351Walls regenerate, reappearing in the order they were destroyed.
352One percent of the regenerated walls will be diagonal walls or doors.
353When a wall is generated directly beneath a player, he is thrown in
354a random direction for a random period of time.
355When he lands, he
356sustains damage
357.Po
358up to 20 percent of the amount of damage already sustained
359.Pc ;
360i.e.,
361the less damage he had, the more nimble he is and
362therefore less likely to hurt himself on landing.
363.\"It
364.\"There is a volcano close to the center of the maze which goes off
365.\"close to every 30 deaths.
366.It
367Every 30 deaths or so, a
368.Ql \&?
369will appear.
370It is a wandering bomb which will explode when it hits someone, or
371when it is slimed.
372.It
373If no one moves, everything stands still.
374But see the
375.Va simstep
376configuration variable in
377.Xr huntd 6
378.It
379The environment variable
380.Ev HUNT
381is checked to get the player name.
382If you don't have this variable set,
383.Nm
384will ask you what name you want to play under.
385If you wish to set other options than just your name,
386you can enumerate the options as follows:
387.Dl setenv HUNT "name=Sneaky,team=1,cloak,mapkey=zoFfGg1f2g3F4G"
388sets the player name to Sneaky,
389sets the team to one,
390sets the enter game attribute to cloaked,
391and the maps
392.Ic z No to Ic o ,
393.Ic F No to Ic f ,
394.Ic G No to Ic g ,
395.Ic 1 No to Ic f ,
396.Ic 2 No to Ic g ,
397.Ic 3 No to Ic F ,
398and
399.Ic 4 No to Ic G .
400The
401.Ic mapkey
402option must be last.
403Other options are:
404.Ic scan , fly , nobeep ,
405.Ic port= Ns Ar string ,
406.Ic host= Ns Ar string ,
407and
408.Ic message= Ns Ar string
409\(em which correspond to the command line options.
410String options cannot contain commas since commas
411are used to separate options.
412.It
413It's a boring game if you're the only one playing.
414.El
415.Pp
416Your score is the decayed average of the ratio of number of kills to number
417of times you entered the game and is only kept for the duration
418of a single session of
95f13fdd 419.Nm .
82a5c12e
MD
420.\" .Pp
421.\" .Nm
422.\" normally drives up the load average to be approximately
423.\" (number_of_players + 0.5) greater than it would be without a
424.\" .Nm
425.\" game executing.
426.Sh STATISTICS
427The
428.Fl S
429option fetches the current game statistics.
430.Pp
431Two groups of statistics are presented: the first group of statistics is
432that of the clients currently connected to the game, and is reset each
433time the client rejoins, while the second group of statistics is on all
434players
435.Pq dead or alive
436by name, and collected over the lifetime of the
437game daemon.
438.Pp
439The meaning of the column headings are as follows:
0533f074 440.Bl -tag -width No -compact
82a5c12e
MD
441.It Score
442the player's last score
443.It Ducked
444how many shots a player ducked
445.It Absorb
446how many shots a player absorbed
447.It Faced
448how many shots were fired at player's face
449.It Shot
450how many shots were fired at player
451.It Robbed
452how many of player's shots were absorbed
453.It Missed
454how many of player's shots were ducked
455.It SlimeK
456how many slime kills player had
457.It Enemy
458how many enemies were killed
459.It Friend
460how many friends were killed
461.Pq self and same team
462.It Deaths
463how many times player died
464.It Still
465how many times player died without typing in any commands
466.It Saved
467how many times a shot/bomb would have killed player if he hadn't
468ducked or absorbed it
469.It Connect
470current connection state(s) of player:
471.Sq p
472for playing,
473.Sq m
474for monitoring
475.El
476.Sh FILES
477.Bl -tag -width Pa -compact
478.It Pa /usr/games/huntd
479game coordinator
480.El
481.Sh SEE ALSO
482.Xr huntd 6
483.Sh AUTHORS
484Conrad Huang, Ken Arnold, and Greg Couch;
485.br
486University of California, San Francisco, Computer Graphics Lab
487.Sh BUGS
488To keep up the pace, not everything is as realistic as possible.
489.Pp
490The historic behaviour of
491.Nm
492automatically starting
493.Xr huntd 6
494is no longer supported.
495.Sh ACKNOWLEDGEMENTS
496We thank Don Kneller,
497John Thomason, Eric Pettersen, Mark Day,
498and Scott Weiner for providing
499endless hours of play-testing to improve the character of the game.
500We hope their significant others will forgive them;
501we certainly don't.