xref: /openbsd/games/hunt/huntd/huntd.6 (revision 3cab2bb3)
1.\"	$NetBSD: huntd.6,v 1.3 1998/01/09 08:03:42 perry Exp $
2.\"	$OpenBSD: huntd.6,v 1.25 2015/09/25 17:50:53 schwarze Exp $
3.\"
4.\"  Hunt
5.\"  Copyright (c) 1985 Conrad C. Huang, Gregory S. Couch, Kenneth C.R.C. Arnold
6.\"  San Francisco, California
7.\"
8.\"  Copyright (c) 1985 Regents of the University of California.
9.\"  All rights reserved.  The Berkeley software License Agreement
10.\"  specifies the terms and conditions for redistribution.
11.\"
12.Dd $Mdocdate: September 25 2015 $
13.Dt HUNTD 6
14.Os
15.Sh NAME
16.Nm huntd
17.Nd hunt daemon, back-end for hunt game
18.Sh SYNOPSIS
19.Nm huntd
20.Op Fl bs
21.Op Fl a Ar addr
22.Op Fl D Ar var Ns = Ns Ar value
23.Op Fl p Ar port
24.Sh DESCRIPTION
25.Nm
26controls the multi-player
27.Xr hunt 6
28game.
29.Pp
30The
31.Fl a Ar addr
32option is used to cause the server to listen only on a
33specific interface address.
34The
35.Ar addr
36argument must be given as an IP address.
37.Pp
38If the
39.Fl b
40option is specified,
41.Nm
42will fork and go into the background.
43In this mode, errors will be logged via
44.Va syslog
45instead of to
46.Va stderr .
47.Pp
48Options given with
49.Fl D
50override those read from configuration files
51.Po
52see
53.Sx CONFIGURATION ,
54below
55.Pc .
56.Pp
57The
58.Fl p Ar port
59option changes the UDP port number used to rendezvous with the player
60process and thus allows for private games of
61.Xr hunt 6 .
62.Pp
63The
64.Fl s
65option is for running
66.Nm
67forever
68.Pq server mode .
69This is similar to running it under the control of
70.Xr inetd 8
71.Pq see below ,
72but it consumes a process table entry when no one is playing,
73and monitor clients are not disconnected.
74.Ss INETD
75To run
76.Nm
77from
78.Xr inetd 8 ,
79you'll need to
80add this line to
81.Pa /etc/inetd.conf :
82.Pp
83.Dl hunt dgram udp wait nobody /usr/games/huntd HUNT
84.Pp
85Do not use any of the command line options \(em if you want
86.Xr inetd 8
87to start up
88.Nm huntd
89on a private port, change the port listed in
90.Pa /etc/services .
91.Ss NETWORK RENDEZVOUS
92When
93.Xr hunt 6
94starts up, it broadcasts on attached networks,
95using the broadcast or point-to-point destination address for each interface,
96to find a
97.Nm hunt
98game in progress.
99If a
100.Nm huntd
101hears the request, it sends back the port number for the
102.Nm hunt
103process to connect to.
104.Ss CONFIGURATION
105When
106.Nm
107starts, it looks for configuration files that determine
108game parameters.
109Each line of a configuration file is of the form
110.Ar var No = Ar value .
111Comments start with a hash sign
112.Pq Sq # .
113The configuration files loaded in order
114.Pq if they exist
115are:
116.Pa /etc/hunt.conf ,
117.Pa $HOME/.hunt.conf ,
118and
119.Pa ./.hunt.conf .
120.Pp
121Many of these variables require intimate knowledge of the
122driver source code.
123The complete list of configurable variables is as follows.
124.Pp
125.Bl -tag -width pdroneabsorb -compact
126.It Va random
127enable dispersion doors
128.Pq default 1
129.It Va reflect
130enable generation of reflection walls
131.Pq default 1
132.It Va monitor
133enable monitors
134.Pq default 1
135.It Va ooze
136enable slime shots
137.Pq default 1
138.It Va fly
139enable flight
140.Pq default 1
141.It Va volcano
142enable volcanoes
143.Pq default 1
144.It Va drone
145enable drone
146.Pq default 1
147.It Va boots
148enable boots
149.Pq default 1
150.It Va scan
151enable scanning
152.Pq default 1
153.It Va cloak
154enable cloaking
155.Pq default 1
156.It Va logerr
157errors to stderr
158.Pq default 1
159.It Va syslog
160errors to
161.Xr syslogd 8
162.Pq default 0
163.It Va scoredecay
164nr deaths before nr kills begins to decay
165.Pq default 15
166.It Va maxremove
167Maximum number of holes in the maze wall
168.Pq default 40
169.It Va linger
170Seconds to keep game open with no players.
171\&-1 means forever
172.Pq default 90
173.It Va flytime
174max time flying
175.Pq default 20
176.It Va flystep
177max displacement each flying time unit
178.Pq default 5
179.It Va volcano_max
180max size of volcano
181.Pq default 50
182.It Va ptrip_face
183percentage chance of tripping a grenade on pickup
184.Pq default 2
185.It Va ptrip_back
186percentage chance of same when backing onto it
187.Pq default 95
188.It Va ptrip_side
189percentage chance of same when walking sideways into it
190.Pq default 50
191.It Va prandom
192percentage of time dispersion doors appear
193.Pq default 1
194.It Va preflect
195percentage of time reflection walls appear
196.Pq default 1
197.It Va pshot_coll
198percentage chance of shots colliding
199.Pq default 5
200.It Va pgren_coll
201percentage chance of grenades colliding
202.Pq default 10
203.It Va pgren_catch
204facing player chance of catching grenade
205.Pq default 10
206.It Va pmiss
207percentage chance of bullet missing player
208.Pq default 5
209.It Va pdroneabsorb
210percentage chance of absorbing a drone
211.Pq default 1
212.It Va fall_frac
213divisor of damage used for fall damage
214.Pq default 5
215.It Va bulspd
216speed of bullets
217.Pq default 5
218.It Va ishots
219initial ammo for player
220.Pq default 15
221.It Va nshots
222ammo boost for all when new player joins
223.Pq default 5
224.It Va maxncshot
225max number of simultaneous shots per player
226.Pq default 2
227.It Va maxdam
228the initial shield for each player
229.Pq default 10
230.It Va mindam
231minimum damage from one unit of ammo
232.Pq default 5
233.It Va stabdam
234damage from stabbing
235.Pq default 2
236.It Va killgain
237shield gained from killing someone
238.Pq default 2
239.It Va slimefactor
240charge multiplier for slime
241.Pq default 3
242.It Va slimespeed
243speed of slime
244.Pq default 5
245.It Va lavaspeed
246speed of volcano lava
247.Pq default 1
248.It Va cloaklen
249duration of a cloak
250.Pq default 20
251.It Va scanlen
252duration of a scan
253.Pq default 20
254.It Va mindshot
255minimum shot class needed to make a drone
256.Pq default 2
257.It Va simstep
258maximum simulation step in microseconds.
259Zero means traditional blocking behaviour.
260Try 55000 for something reasonable
261.Pq default 0
262.El
263.Sh FILES
264.Bl -tag -width Pa -compact
265.It Pa /etc/hunt.conf
266.It Pa "$HOME/.hunt.conf"
267.It Pa ./.hunt.conf
268.El
269.Sh SEE ALSO
270.Xr hunt 6 ,
271.Xr inetd 8
272.Sh AUTHORS
273.An -nosplit
274.An Conrad Huang ,
275.An Ken Arnold ,
276and
277.An Greg Couch ;
278.br
279University of California, San Francisco, Computer Graphics Lab
280.Pp
281.An David Leonard
282tidied up, and added the configuration file.
283