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 30controls the multi-player 31.Xr hunt 6 32game. 33.Pp 34The 35.Fl a Ar addr 36option is used to cause the server to listen only on a 37specific interface address. 38The 39.Ar addr 40argument must be given as an IP address. 41.Pp 42Options given with 43.Fl D 44override those read from configuration files 45.Po 46see 47.Sx CONFIGURATION , 48below 49.Pc . 50.Pp 51The 52.Fl p Ar port 53option changes the UDP port number used to rendezvous with the player 54process and thus allows for private games of 55.Xr hunt 6 . 56.Pp 57The 58.Fl s 59option is for running 60.Nm 61forever 62.Pq server mode . 63This is similar to running it under the control of 64.Xr inetd 8 65.Pq see below , 66but it consumes a process table entry when no one is playing, 67and monitor clients are not disconnected. 68.Ss INETD 69To run 70.Nm 71from 72.Xr inetd 8 , 73you'll need to 74add this line to 75.Pa /etc/inetd.conf : 76.Pp 77.Dl hunt dgram udp wait nobody /usr/games/huntd HUNT 78.Pp 79Do not use any of the command line options \(em if you want 80.Xr inetd 8 81to start up 82.Nm 83on a private port, change the port listed in 84.Pa /etc/services . 85.Ss "NETWORK RENDEZVOUS" 86When 87.Xr hunt 6 88starts up, it broadcasts on attached networks, 89using the broadcast or point-to-point destination address for each interface, 90to find a 91.Nm hunt 92game in progress. 93If a 94.Nm 95hears the request, it sends back the port number for the 96.Nm hunt 97process to connect to. 98.Pp 99Regardless of how 100.Nm 101is started, it always checks incoming connections with 102.Xr hosts_access 5 , 103using a service name of 104.Sq huntd . 105.Ss "CONFIGURATION" 106When 107.Nm 108starts, it looks for configuration files that determine 109game parameters. 110Each line of a configuration file is of the form 111.Ar var No = Ar value . 112Comments start with a hash sign 113.Pq Sq # . 114The configuration files loaded in order 115.Pq if they exist 116are: 117.Pa /etc/hunt.conf , 118.Pa "$HOME/.hunt.conf" , 119and 120.Pa ./.hunt.conf . 121.Pp 122Many of these variables require intimate knowledge of the 123driver source code. 124The complete list of configurable variables is as follows. 125.Pp 126.Bl -tag -width pdroneabsorb -compact 127.It Va random 128enable dispersion doors 129.Pq default 1 130.It Va reflect 131enable generation of reflection walls 132.Pq default 1 133.It Va monitor 134enable monitors 135.Pq default 1 136.It Va ooze 137enable slime shots 138.Pq default 1 139.It Va fly 140enable flight 141.Pq default 1 142.It Va volcano 143enable volcanoes 144.Pq default 1 145.It Va drone 146enable drone 147.Pq default 1 148.It Va boots 149enable boots 150.Pq default 1 151.It Va scan 152enable scanning 153.Pq default 1 154.It Va cloak 155enable cloaking 156.Pq default 1 157.It Va logerr 158errors to stderr 159.Pq default 1 160.It Va syslog 161errors to 162.Xr syslogd 8 163.Pq default 0 164.It Va scoredecay 165nr deaths before nr kills begins to decay 166.Pq default 15 167.It Va maxremove 168Maximum number of holes in the maze wall 169.Pq default 40 170.It Va linger 171Seconds to keep game open with no players. \&-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 hosts_options 5 , 271.Xr hunt 6 , 272.Xr inetd 8 273.Sh AUTHORS 274Conrad Huang, Ken Arnold, and Greg Couch; 275.br 276University of California, San Francisco, Computer Graphics Lab 277.Pp 278David Leonard tidied up, and added the configuration file. 279