----------------------------------------------------------------------

Voosh v1.0 - Quake 3 Arena

Index:

1.  Discription
2.  Voosh.cfg and Ammo Regeneration
3.  Offhand Grappling Hook
4.  Installation
5.  Running a Server
6.  Credits

----------------------------------------------------------------------
1.  Discription

	Voosh is a server-side modification for Quake III Arena that provides the admin with the control to pick any weapons they want and run a timed rotation in which each player has the same weapon.  The purpose is to create an extremely balanced game.  After a certain period of time each player's weapon is switched to the next in line, set up by the server in the Voosh.cfg file.  Setting up a server is very simple with the use of the Voosh.cfg (configuration) file located in the Voosh base directory.  Simply open the Voosh.cfg with a text editor.  Admin's can pick the starting weapon, how long each weapon will be used, and can even disable weapons, or the whole rotation so that their server runs only a single weapon.  Once the server has started, all players will spawn with the chosen weapon, and no other weapons or ammo will spawn on the level.  The ammo level for each player will continually regenerate at a slow rate.  After the first 30 seconds with the first weapon, the weapon cycling will begin, and progress in order.  Messages will be displayed for the last three seconds before each weapon switch.  Additionally, the Gauntlet does infinite damage, and a "Voosh Mode" can be enabled, which makes the railgun do 8x damage.

Voosh supports:
Free for All Deathmatch
Teamplay Deathmatch
Tourney Deathmatch
Capture the Flag


----------------------------------------------------------------------
2.  Voosh.cfg and Ammo Regeneration

The following variables can be accessed via the Voosh.cfg (found in the Voosh directory) to change the settings of Voosh.

This variable sets the first weapon in use, or the only weapon if the "switch_weapons" variable is set to 0.  Replace the # with a number from 1 to 9, corresponding to the weapon list provided below.

start_weapon #

Gaunlet - 1
Machinegun - 2
Shotgun - 3
Grenade Launcher - 4
Rocket Launcher - 5
Lightning Gun - 6
Railgun - 7
Plasma Gun - 8
BFG - 9

----

This variable toggles Voosh Mode, which gives the railgun 8x damage.  Replace # with a 0 (disabled) or a 1 (enabled).

voosh_mode #

----

This variable toggles the weapons rotation.  Replace the # with a 1 or 0 to enable or disable the weapon rotation.

switch_weapons #

----

These variables determine how long each weapon is in use.  Replace the #'s with the number of seconds that each weapon will be used.  To disable a weapon (means it will be skipped in the rotation) set the value to 0.  If all variables are set to zero, it is the equivalent of turning of the rotation and the weapon will become the start_weapon selected above.

gauntlet_time #
machinegun_time #
shotgun_time #
grenadelauncher_time #
rocketlauncher_time #
lightninggun_time #
railgun_time #
plasmagun_time #
bfg_time #


----

Ammo Respawn Amounts (for every two seconds):

Bullets	= 12
Shells	= 1
Grenades	= 1
Rockets	= 1
Lightning	= 15
Slugs	= 1
Cells	= 7
BFG	= 2

These are not adjustable.  The amounts main seem small, but they continually regenerate, even while shooting.  Continuous shooting will leave you with no ammo, but you should be able to fire almost all the time without running out at these regeneration levels.

----

The following variable can enable force teams on your server.  Set it to 0 for off, 1 for on.  While on, players skip spectator mode upon entering the game and instead join the team with fewer players.

force_teams #


----------------------------------------------------------------------
3.  Offhand Grappling Hook

An offhand grappling hook has been added to Voosh.  It is activated with the +button5 command.  You must bind it to a key with the following syntax:

bind <key> +button5

Replace <key> with any key on your keyboard.  For example, this will bind the command to your "g" key:

bind g +button5

Pressing and HOLDING that key will fire the grappling hook and then draw you in if you hit something.  Releasing that key will release the hook.

The server may disable the grappling hook with the "grappling_hook" variable in the Voosh.cfg.


----------------------------------------------------------------------
4.  Installation

Unzip the Voosh10.zip into your Quake 3 directory (default is C:\Program Files\Quake III Arena\)

Make sure to preserve the directory structure.  It should create a "Voosh" folder with all the necessary files inside.


----------------------------------------------------------------------
5.  Running a Server

The included "Voosh" link will start up Quake 3 with the mod enabled, but you'll need to make sure the target in the shortcut's properties is pointing to the correct location of your Quake3.exe.  The fs_game variable MUST be set from a command line.  It cannot be done while in game.  It is also necessary at this point in time to set the sv_pure variable to 0 in order to allow clients to connect.  During gameplay you can change any of the variables, and the changes will take place after a map change.  The settings in the Voosh.cfg file are read only at game startup, and not in between map changes.  Remember, Voosh is server-side, clients do NOT have to download anything to play.


----------------------------------------------------------------------
6.  Credits

Programming - Willi Roberson
tadao@stargate.net

Webpage - Telcanty
french@mainsite.com