**************
CHAPTER HONOUR
**************
a Warhammer 40,000 TC for Quake

-= Server Admin Guide =-

2/2/99

SERVER.CFG

A server.cfg file should be included in your 40K directory along with this
file.  If you intend to run a server, you should execute this file as
part of your server's command line (via "+exec server.cfg").  This file
contains all of the server options, and is designed so that a server admin
can quickly and easily set up a server.  The following is a detailed
description of each variable in server.cfg.


hostname

The name of the server.  This is what shows up in programs like GameSpy,
and in the rare case the server broadcasts a message.


sys_ticrate

How often, in seconds, the server will send updates to the clients.
0.05 is the Quake default, but 0.1 is much more friendly to modem users.
It is recommended that you not alter this setting except when running a LAN
only server.


sv_maxspeed

The maximum speed a player can move.  The Quake default
is 320, but this is much too fast for such a deadly combat system.
A setting of 266 is good for a lower number of players, while a setting
of 200 is recommended for large or Chapter (clan) matches.
This variable is forced to 200 in tabletop mode.
NOTE: Do NOT alter this variable once the game is started.  If you wish to
change the speed of a game in progress, use the Admin menu (see below).


teamplay

The level of friendly-fire allowed.  The default value of 2 means that
you cannot harm friends except with template weapons (flamers, weapons
with area effect).  Set this to 1 to allow teammates to injure each
other normally.  Under no setting will teammates be targetted.


sv_aim

The game's targetting mode.  The default value of 1 puts the game in
"auto-targetting" mode.  Shots will automatically be aimed (including
leading) at the current target (indicated by target ID, if the client
has the option on).  A Ballistic Skill roll is made, and if a miss is
rolled, the shot scatters.  Set this variable to 2 to disable auto-
targetting, in which case the BS roll is made when the projectile hits
a target.  This makes the game more action-based (but more difficult
for players with higher ping times).


skill

The skill value adjusts the rate at which AI guards and monsters (e.g.
Genestealers) will spawn.  This can effect the level to which guards
and neutral monsters will play in a game.  The default of 2 is an
average setting.


samelevel

This variable has been effectively reversed from the way it works with
standard Quake.  A setting of 0 will maintain the current map, whereas
any other number will indicate which map in the map rotation that will
be run next.  See the map rotation (below) for more information.  The default
of 2, coupled with the starting map being the first in the rotation, will
cause a sequential progression.


deathmatch

While the deathmatch variable still serves the purpose of putting the game
into deathmatch mode, it also has a second function.  It can be used to
specify what chapters will exist in the game.  If you wish to force the
server to always contain the same one or more Chapters, use the Admin menu
(see below) to specify the Chapters you wish.  Then, BEFORE restarting,
determine the current deathmatch value by typing "deathmatch" at the server
console.  If you set the deathmatch to this number, it will create the
Chapters specified.
The default value of 1 randomizes all Chapters.


fraglimit

This is no longer a limit on the number of individual frags a player may
get before the game ends.  It is now the total number of points needed
by a team to achieve victory.  Generally, a setting of 2000 for a shoter
game up to 4000 for a larger game is acceptable.  Settings higher than
4000 should be limited to games with a very large number of players, since
if the game becomes too lengthy, those who join in late will have a very
difficult time in an environment full of high point players.

In tabletop mode, this value is the base amount of points available to each
team (but is adjusted by the number of players in the game).

If you wish to change this variable during the game, use the admin menu
(see below) instead of altering it from the server's console.


nomonsters

This variable stores the current game options as set by the Admin menu.
If you wish to start the server with a specific set of options already
disabled, use the Admin menu (see below) to set the options, then check
the current value of the nomonsters variable by typing "nomonsters" at the
server console, and use that value in the server.cfg.


temp1

This important variable restricts access to the Admin menu and functions
to those who enter the correct codes.  Set the "xxx" to the first impulse
that must be entered, and "yyy" to the second.  The 0 must be between them.
Once set, a client must enter the first impulse immediately followed by
the second.  This will grant them Admin rights (there is no confirmation),
giving them the ability to perform all Admin controls (see below).
As long as temp1 is not 0, cheating is disabled.

Thanks go to Hap of Freeform Interactive for the core passcode system.


MAP ROTATION

To use map rotation you must do three things:

1) Set the "samelevel" server variable

If you wish for the server to go through your map rotation, it must have
the samelevel variable set.  You may set it to any number from 1 to 9,
where the number specified is which map (see next section) will be the first
one rotated to.  To put the rotation on "random", set samelevel to 10.

Samelevel 0 can be set to ignore map rotation and remain on the same map.

NOTE: The samelevel variable functions normally in non-deathmatch modes.


2) Create "mapX.cfg" files, where X is a number from 1 to 9

The mapX.cfg files specify the maps to be loaded.  They can also specify
any server variables to be set for that map (e.g. fraglimit, timelimit,
gravity, autoaiming, sv_maxspeed).  An example map1.cfg file may look like:

fraglimit 2000
timelimit 10
changelevel dm3
samelevel 2

The samelevel 2 is vital - it specifies which map to load next (in this case
map2.cfg).  Your last mapX.cfg file should specify samelevel 1.  You can,
however, set the last one to samelevel 10 if you wish to randomize after
going through a progression.  Server admins can also change to a specific
level (or randomize) through the in-game admin menu.


3) Create a "maplist.cfg" file

This file is a simple list of maps, so that an admin user can tell what
number to enter when changing maps.  It should simply be formatted:

say "1: Ultramar Proving Grounds
say "2: Fenris wilderness
say "3: Terra training facility
...

The quote should only be placed at the beginning, trailing quotes will appear.


ADMIN CONTROLS

A client with admin rights (see temp1 above) can make a great deal of changes
to the game from within Quake.  A list of these abilities follows:


Admin main menu: impulse 250

The Admin menu provides the bulk of admin abilities.  Most entries are
self-explanatory.  As a general rule, any function which requires the entry
of a number (game speed, fraglimit) will allow the use of backspace, so
long as it has not been rebound to a new impulse.  In order to execute
a number being entered, the admin impulse (250) should be done.  I recommend
an out-of-the-way key be bound to "impulse 250" for ease of use.


changelevel: impulse 251

This impulse executes a changelevel to the level specified by the admin's
name.  To use, change your name to that of a level (e.g. "start"), then
perform the impulse.
CAUTION: If your name is an invalid map (i.e. misspelled, or not on the
server), this will cause the server to CRASH.  It is HIGHLY recommended
you use the change map function from the admin menu.


execute: impulse 252

This impulse allows the admin user to execute any command, again specified
by the user's name.  Unfortunately, a player's name has a limited number
of characters, so only shorter commands will be possible.  Also, while most
invalid commands will error harmlessly, some could crash the server.  Use
this function with extreme caution, and only if the admin menu does not
accomodate the function.


Let me know if there are any functions you frequently use that are not avail-
able on the Admin menu, or game options you wish there were.

-Fireball
fireball@stomped.com
