Title    : Rocket Arena 2
Filename : ra2096sv.zip
Version  : 2.096
Date     : 1-28-98
Author   : David 'crt' Wright
Email    : wrightd@stanford.edu
Author   : Mungo
Email    : bml@netwiz.net
Webpage  : http://www.planetquake.com/servers/arena

Intro
-----
Please read this entire file, as it contains important info on installation.
Also, be sure to read the readme.txt included in the
client package.
Version changes are now recorded at the end of this document

Installation Instructions
-------------------------
This is the server package for Rocket Arena 2. You will also need the client
pak (a seperate download) installed on the server. Download it and install
according to the included instructions.

Extract the gamex86.dll and *.cfg files to your \quake2\arena directory.

You can put the raserver.bat in your \quake2 directory.

Customize the server.cfg to your tastes. It includes the admincode (see below)
which will allow for in-game configuration of the mod. Please change this
code!

Customize the maploop.cfg file to set a custom map rotation. List all the maps
you want to rotate through, one per line. You can repeat maps (as in the
example config) without going back to the beginning.

Please see below for info on the arena.cfg file, used to customize settings
on a per level/per arena basis.

Customize the raserver.bat file if needed as well.

Once your server is running, you will want to register it with the PlanetQuake
Quake 2 server list (http://planetquake.com/q2servers/index.shtml#submit) so
that people are able to find it. I will not be posting Rocket Arena 2 servers
on the Rocket Arena web page, so please don't ask.

Administration / Mod setup
--------------------------
There are several console variables which control how the mod functions.
These provide the default values for each level/arena if no others are
specified in the arena.cfg file.

"playersperteam" is the number of players needed on each team. For 1v1, leave
this at 1. For 2v2, set it to 2, etc..

"armor" is the starting armor for players

"health" is the starting health for players

"minping" is the minimum ping to play on the server. People with lower
pings will be able to join the server, but unable to enter any arenas.

"maxping" is the maximum ping


"weapons" is a bitmask for the default weapons. Add up these values:
Weapon Number:         2  3  4  5   6   7   8    9    0
Amount to Add:       { 1, 2, 4, 8, 16, 32, 64, 128, 256 }
The default is 255 (no bfg). Set it to 512 to allow BFG (and all others) for example.

"admincode" is the code (up to 8 digits) that you set to allow in-game
administration of the server.

In Game Administration
----------------------
To use the in game administration, just type /cmd admin <admincode>
(e.g. /cmd admin 1234)

It will pop up a menu allowing you to select things like fraglimit, timelimit,
playersperteam, teamsperarena, etc. You can also cycle through all the maps in
the maploop.cfg file. Use invuse (ENTER) to increment a value and invdrop (')
to decrease it.

Eventually administration will be done on a per-arena basis, with voting for
admins.

arena.cfg file
--------------
The arena.cfg file allows you to specify map options on both a per map and per
arena basis.
Information is stored in a hierarchical format. Priority goes in order to:
1. Values for that specific arena
2. Values for that map
3. Global values defined in server console vars

The format of the file is:
<mapname> {
//comment
	<map default option>;
	<map default option>;
	<map default option>;
	<arena number> {
			<arena default option>;
			<arena default option>;
			<arena default option>;
	}
	<arena number> {
			<arena default option>;
	}
}

For example:
ra2rg1 {    // <-- ra2rg1 is the map name
		weapons: 2 3 4 5 6 7 8 9; //<-- these will be the default weapons, if none are specified for an arena
		armor: 200; //<-- default health if none is specified
		health: 100; //<-- default armor
	1 {
		weapons: 2 3 4 5 6 7 9; //<-- arena 1 takes out hyperblaster
		armor: 100;  //<-- reduces default armor to 100
		playersperteam: 2; //<-- 2v2 matches
	}
	2 {
		weapons: 2 3 4 5 6 7 8 9 0; //<-- all weapons allowed
		armor: 150; //<-- only 150 armor
		health: 90; //<-- 90 health to start
	}
	3 {
		minping: 180;
	}
//because arena 3 and 4 do not specify, they will use the map defaults
//(2,3,4,5,6,7,8,9) weapons, 200 armor, 100 health
//you do not need to list all the arenas, unlisted ones will use defaults
}

Available Options are:
weapons: 2 3 4 5 6 7 8 9 0;
     where the number corresponds to the default Q2 binding (2 = shotgun, 0 = bfg)
armor: <value>;
health: <value>;
playersperteam: <value>;
minping: <value>;
maxping: <value>;


Please take a look at the included arena.cfg for some more examples.

Map Credits
-----------
As you can see, we only included one map in this release. This is mainly a
testing/feedback release, and many many maps are in progress. I converted
this map from a Q1 Multi-Arena map done by Tesh that was never really
released.

ra2rg1   Multi-Arena             Ralph 'tesh' Gustavsen
<clg@coastlinegraphics.com>
                                 http://www.coastlinegraphics.com                                                                      

Other Credits
-------------
I would like to personally thank all the Rocket Arena fans out there who
have written me TONS of mail with compliments, comments, and suggestions for
the mod. Also, I would like to thank Basty and the PlanetQuake guys for
their support and resources.

Copyright and Distribution Permissions
--------------------------------------

This patch is freely distributable provided that this readme is distributed
as well and is unchanged.

All code is copyright PlanetQuake 1998.
Commercial code licensing is available by contacting wrightd@stanford.edu

DISCLAIMER: THE PROGRAM IS DEFINED AS THE QUAKE 2 MOD "ROCKET ARENA 2" AND
  ALL FILES CONTAINED WITHIN.
  BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  REPAIR OR CORRECTION.


Availability
------------

This modification is available from the following places:

WWW   : http://www.planetquake.com/servers/arena

Version History
---------------
2.09
Initial Release

2.094
Better server stability, minor gameplay tweaks

2.096
100% server reliablity
Advanced configuration, on both a per map and per arena level:
-Default Weapons
-Starting health/armor
-Number of players per team
-Ping filtering
Enhanced teamplay
Player status for observers
New sounds
Teamplay works on maps with only a few spawn points
(people don't get stuck)
