games/hunt/huntd/huntd.6

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