Title : Rocket Arena 2 Filename : ra2211sv.zip Version : 2.110 Version : 2.110 Release Date : 4-10-98 Authors : David 'crt' Wright Mungo Web Page : http://www.planetquake.com/servers/arena Discussion list: rocketarena-subscribe@list.criticalmass.com ----- Intro ----- Please read this entire file, as it contains important info on installation. Many options have changed/been added in this version, so please double check everything, even if you are just upgrading. Also, be sure to read the readme.txt included in the client package. ------------------------- 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. Please note that on Unix machines you may need to rename the client EXE file to a ZIP file and unzip it manually. Extract all of the 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! Please see below for info on the arena.cfg file, used to customize settings on a per server/per level/per arena basis. It now includes map rotation information as well. Customize the raserver.bat file if needed as well (maxclients, etc). You can edit the "motd.txt" file to display a message to connecting clients. See the included one for line size information. ************************** IMPORTANT!!! ************************** The default settings in server.cfg include: set public 1 setmaster q2master.planetquake.com set logfile 2 set netlog ripper.stanford.edu:21998 The first two lines publish your server on the PlanetQuake master list so that people can see it in GameSpy. If you don't want your server to be public, set public 0 and remove the setmaster line. The second two lines enable net logging. See below for net logging info. If you are running on a LAN and not connected to the Internet, REMOVE THESE LINES!! If the server crashes after the first frag, then it is having trouble sending the net logging info and you should turn net logging off. -------------- Server Crashes -------------- Server crashes will not be tolerated! RA2 has been designed and tested to be a highly reliable mod. If you are experiencing server crashes. please contact me asap so we can track down the cause. If you have physical acess to the server, the following info would be useful following a crash: 1. The full text of the "Details" box on the crash dialog 2. The text on the console at the time of crash 3. The qconsole.log file in the arena directory after the crash (deleted when the server is restared, so grab it fast!) -------------------------- Administration / Mod setup -------------------------- There are several console variables which control how the mod functions. Most other options have been moved to the arena.cfg file. "set logfile 2" will let RA2 create an STDLOG.LOG file in your Quake 2 directory that records all the info for the game. You can then parse this log with GibStats (www.planetquake.com/gibstats) to obtain ranking/stat information. "set admincode 1234" is the code (up to 8 digits) that you set to allow in-game administration of the server. "set netlog ripper.stanford.edu:21998" will send all logging information to that machine. See below for net logging information. (please note that the new default port for the release version is 21998, not 21999 as it was in the first beta) "set public 1" will allow the server to be displayed on the id list. You MUST set public 1 for your netlog stats to be accepted. -------------- arena.cfg file -------------- The arena.cfg file allows you to specify map options on a: 1. per server 2. per map 3. per arena basis Information is stored in a hierarchical format. Priority goes in order to: 1. Values for the specific arena 2. Values for that map 3. Global values defined at the top of the arena.cfg file 4. Default values stored in the code. The format of the file is (note that the < > characters are not typed!): ; ; { //comment ; ; ; { ; ; ; } { ; } } For example: //-----------START OF FILE------------ maploop: ra2map1 ra2map3 ra2map5 q2dm1; // <-- sets the map rotation for the server minping: 150; // <-- sets the default minimum ping to 150 for all arenas ra2map1 { // <-- ra2map1 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 rounds: 3; //<-- 2 out of 3 rounds wins the match } 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 pickup: 1; //<-- designates this as a pickup arena rounds: 9; //<-- 5 out of 9 rounds takes the match } 3 { minping: 0; //<-- overrides the minping:150 set on the server. Everyone can play here } 4 { weapons: 0; //<-- only blaster and BFG are allowed health: 500; //<-- start with a ton of health armor: 500; //<-- and lots of armor cells: 999; //<-- starting cells is 999 now } //you do not need to list all the maps/arenas, unlisted ones will use defaults } q2dm8 { minping: 0; //all people allowed on this map. Overrides global 150 value pickup: 1; //all arenas (only 1 actually) will be pickup rounds: 9; //best 5 of 9 cells: 50; //can't go crazy with hyperblaster } 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: ; health: ; playersperteam: ; //maximum number of players to allow on a team. Smaller teams can join, and players can join teams already in arenas. minping: ; maxping: ; rounds: ; max_teams: ; //to limit the teams in an arena. Automatically set to 2 for pickup arenas. pickup: <1/0>; //enable / disable pickup teams for this arena (disabled by default) shells: ; bullets: ; slugs: ; grenades: ; rockets: ; cells: ; Please take a look at the included arena.cfg for some more examples. If you settings are not being used, please make sure that: 1. you have a ":" (colon) seperating the identifier and the value 2. you have a ";" (semi-colon) at the end each line Please direct any arena.cfg related questions/comments to Mungo at the e-mail address above. The default values if none are specified in the config are: weapons : 2 3 4 5 6 7 8 9; armor : 200; health : 100; minping : 0; maxping : 1000; playersperteam : 1; max_teams : 128; shells : 100; bullets : 200; slugs : 50; grenades : 50; rockets : 50; cells : 150; fastswitch : 1; armorprotect : 2; healthprotect : 1; if (it is a multi arena map) pickup : 0; rounds : 1; else (it is a id / single arena map) pickup : 1; rounds : 9; ------------ Pickup Teams ------------ Rocket Arena 2 now supports Clan Arena style pickup teams. Simply set "pickup: 1;" for any arena/map you want to have pickup teams on. Two teams will appear on the main menu (arena # red/arena # blue), and players will be able to join one of the teams and instantly be put in the arena. You should also set multiple rounds "rounds: 9;" or so, so that the matches last a bit longer. There is a 15 second waiting period between matches, so that players can switch teams if they want. ------------ Net Logging ------------ Rocket Arena 2 has network logging support. To enable this add: "set public 1" and "set netlog ripper.stanford.edu:21998" in your server.cfg file. This will send kill information to that machine for central collection and analysis. This system is not 100% reliable (about 1/1000 kills are lost in transit) but is STRICTLY FOR FUN, so if you're looking for more serious/accurate rankings, do them for your own server only. Right now all I am doing with the netlog data is displaying the top 5 fraggers of the day on the top of the Rocket Arena page. Future uses may be considered. The comprehensive stats were dicontinued because they fostered an environment of intense competition that made many people uncomfortable. ---------------------- In Game Administration ---------------------- To use the in game administration, just type /cmd admin (e.g. /cmd admin 1234) It will pop up a menu allowing you to select things like fraglimit, timelimit, and map. You can cycle through all the maps in the maploop: line in the arena.cfg file. Use invuse (ENTER) to increment a value and invdrop (') to decrease it. Arena administration is done by typeing: /cmd arenaadmin (e.g. /cmd arenaadmin 1234 1) This will give you a menu similar to the voting menu, but you can force the changes. ------- Credits ------- Please see the client readme for full credits. -------------------------------------- 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 mark@criticalmass.com 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) 2.098 Q2 3.13 compatible, based on 3.05 code Voting system for arena settings Enhanced arena.cfg with more options Centralized stats system Pickup team play Talk commands on a per arena basis MOTD support changes in map rotation (done in arena.cfg now) 2.110 First full release version Fixed menu code Lots of new options, for players and servers