// OSP Tourney DM Client/Server Command Listing
// ============================================
// rhea@ittc.ukans.edu
// 01 Jul 1999
//
// Version(2.5)
//

Server commands:
----------------
	sv allready - Forces all clients to "ready" status.
	sv allnotready - Forces all clients to "not ready" status.
	sv mpause - A toggle that pauses/unpauses a match.
	sv playerlist - Reloads the current specified playername list.
		--> If a filename is specified with this command, the
		    player list will be loaded from the specified file.

Gladiator Bot control:
	sv addbot <bot's_name> <skin> <charfile> <charname> - Adds specified bot
	sv removebot [bot's_name] - Removes specified bot.  If no name specified,
					    then first found bot will be removed.
	sv addrandom [number] - Adds a random bot to the game.  If a numeric
					[number] is included, it will add [number]
					random bots.
	----> For other Gladiator bot-related commands, please refer to the
		Gladiator documentation found in the "gladiator/" directory
		or visit http://www.botepidemic.com/gladiator.

IP banning (same interface as vanilla 3.20 DM):
	sv addip <ip-mask>  - adds an ip to the ban list
	sv listip <ip-mask> - removes an ip from the ban list
	sv removeip <ip-mask> - remove an ip from the list
	sv writeip - writes the ban list to <gamedir>/listip.cfg.
	  --> You can exec this .cfg on a server load to load the list
		on subsequent server runs:
			quake2 +set dedicated 1 +exec listip.cfg
	Note:  The <ip-mask> is a simple mask system.  Adding 192.168 to
		 the list would block out everyone in the 192.168.*.* net
		 block.  Currently, you have up to 1024 banned subnets.

A new cvar is also supported called 'filterban'.  It defaults to
"1" which means "allow everyone to connect _except_ those
matching in the ban list."  If you set it to "0", the meaning
reverses to: "Don't allow anyone to connect unless they are in
the list."

Client commands:
----------------
	motd - bings up current Message Of The Day.
	id - enables/disables player identification, if allowed by server.
	ready - puts client in "ready" status if in match mode.
	notready - puts client in "not ready" status if in match mode and
		   if the match has not already begun.
	menu - Pulls up client menu (just like hitting inven key).
	matchinfo - if the server is not in deathmatch-only mode, then the
		    client will be shown the parameters of the current match.

	players - Lists all active players in the game.  It gives the clients'
		    ID #, name, and [BOT] if they are a Gladiator server-side bot.

	chasecam - Takes client out of game and puts them into "chasecam" mode.
		   This option is not allowed if a qualifier/team/1v1 match is
		   in progress.  It is also used as a toggle to leave chasecam
		   mode and return to play.
	chase - Same as "chasecam".

	observe - Takes a client out of the game and puts them into "observer"
		  mode.  This option is not allowed if a qualifier/team/1v1
		  match is in progress.
	observer - Same as "observe".

	autocam - Takes client out of game and puts them into "autocam" mode.
		    Can also be used to toggle out of autocam mode and return
		    to a game in progress (if allowed).  [Subcommands for the
		    autocam can be found further below.]

	hook/+hook/+grapple - Activates the hook (if enabled).
	unhook/-hook/-grapple - Dectivates the hook (if enabled).

	droprune/drop rune - If runes are enabled, allows the client to drop
				   the rune they are holding.

	join/joingame - In FFA play (Regular/Qualifier DM), allows client to join
			    a game in progess.

	accuracy/stats - Shows player's current hit/attempt statistics for all
			 weapons that have been used by the player within the
			 game, except the BFG10K.  I figure that I would spare people
			 the possible embarrassment of having an accuracy of LESS than
			 100% with this silly weapon :)

	oldstats - If used by itself, shows the players whose stats are available
		     from the previous round.  If used with a correct playername,
		     displays their stats from the previous round.

	oldscores - Displays the scoreboard from the last match played.

	highscores/hiscore - Displays the high scores for a given map, if in FFA mode.

	talkto/tell/talk <player_name|ID> - Sends a message to a specific player.

	hud - Allows client to toggle positioning of countdown timer from right
	      side to bottom-middle.  Can also be done from menus.

	referee/admin/ref - Allows a player to have access to the referee commands
				 (listed below).  This command requires the player to
				 include either the referee_password or rcon_password
				 to gain this status.

	vote -  Allows client to propose changes to the current match.  These
		changes, if passed, will be good only for the current round of
		play.  Loading of the next map will force default values to be
		reset.  The following things are available for voting:
			      map:  Player can choose from any map in the queue.
		   timelimit/tl:  Change current timelimit
		   fraglimit/fl:  Change current fraglimit
			     hook:  Enable/disable hook in match.
			     quad:  Enable/disable quad damage in match.
			      bfg:  Enable/disable BFG10K in match.
			  toggles:  Bitwise (OR) setting of particular items.
				      (See below for these settings).
			  addbots:  Propose to add <#> bots.
			  rembots:  Propose to remove <#> bots.
			   config:  Selects new server config.
			    runes:  Enable/disable Lithium-style runes.
			     kick:  Kicks a particular player from the server.
			      yes:  Votes "yea" for current proposal.
			       no:  Votes "nay" for current proposal.
		Issuing a "vote" by itself will give information on the current
		proposed change in progress.  If there is no proposal, then the
		client will be given a list of options to choose from.  This is
		the same if issuing a "vote <option>", with more specific infor-
		mation on the <option> in question.  A threshold must be reached
		by all clients in the game to approve or deny a vote proposal.
		It should be noted that all of these settings can be done through
		the menu interface as well.
	yes - If a vote is in progress, allows the client to approve the vote.
	no - If a vote is in progress, allows the client to deny the vote.

	[ TOGGLE vote item settings (setting value means to enable): ]
		ALLOW_QUAD       :    1
		ALLOW_INVUL      :    2
		ALLOW_QUADDROP   :    4
		ALLOW_BFG        :    8
		ALLOW_POWERARMOR :   16
		ALLOW_WEAPONSTAY :   32
		ALLOW_SELFDAMAGE :   64
		ALLOW_TEAMDAMAGE :  128

Additional Autocam commands:
----------------------------
The following commands can be used with the "autocam" command to
adjust the camera's characteristics:
		follow = Follows the current player, and does not switch.
		normal = Normal tracking of clients for approximately 15 seconds,
			   before switching to another player.
		min_xy = Differential behind player correction rate (movement along
			   the XY-plane).
		min_z = Differentail height correction rate (movement vertically
			  up or down from player's view hight).
		min_angle = Differentail YAW correction rate (rotate on XY-plane).
				Consider this as the "panning" rate of the camera as
				it focusses on the currently tracked player.

Teamplay/1V1 (where applicable) commands
----------------------------------------
	teamname - If in team match mode, allows player to view or change
		   his/her team's name.
	teamskin - If in team match mode, allows player to view or set his/her
		   team's skin.
	say_team/steam - Sends messages ONLY to members on your team.  CTF-based
			     "%" messages are also available to give player info,
			     location, sightings.
	join/team - If in team match mode, allows player to join a specified team.
		    If no arguments are given, this command shows the player's
		    current team, if he/she is in the game.
	joincode - Allows observers to join a match in progress.  For players
		     already in the game, gives them the team's joincode.  The
		     captain also has the option to set the joincode manually.
	switchteam - Allows a client to switch teams if he/she is already on
		      the opposing team.  Players can also switch during a match,
		      but they must first be "invited" by an opposing team's
		      player.
	invite - If in team match mode, allows a player to "invite" another
		  player (in observer mode) to join his/her team if a match is
		  already in progress.
	pick/pickplayer - Same as the "invite" command, listed above.
	lockteam/teamlock/lock - "Locks" the team's current player count.  No
				 other players will be allowed to join the team
				 unless they are "invite"d.
	unlockteam/teamunlock/unlock - "Unlocks" a team's player count to allow
				       anyone to join the team.
	readyteam/teamready - Readies the entire team (Captain-use only)
	unreadyteam/notreadyteam - Unreadies entire team (Captain-use only)
	captain <player_name> - By itself, lists current team captain.
				The captain can also add the <player_name>
				parameter to give captain-ship to <player_name>
	kickplayer/remove <player_name|player_ID> - Removes <player_name>
				(or player_ID) from team (Captain-use only).
	time/matchpause/timein - Calls a time-out/time-in, depending on current
					 match paused status (Captain-use only).
	checkpoint <string>: Notifies teammate bots of location of checkpoint
				   labeled as <string>.


REFEREE-CLIENT COMMANDS:
========================
	r_help - Displays usage info on all referee-specific commands.
	r_kick - Kicks a specified player.
	r_mpause - Pauses/unpauses a match in progress.
	r_map - Allows for selection of any map in the map queue.
	r_timelimit - Sets server's timelimit.
	r_fraglimit - Sets server's fraglimit.
	r_stopmatch - Stops a match that is currently in progress.
	r_allready - Sets all clients to ready status, if in a synced match.
	r_allnotready - Sets all clients to notready status.
	lockteam/teamlock/lock <teamname> - "Locks" <teamname>'s current player
				 count.  No other players will be allowed to join the
				 team unless they are "invite"d.
	unlockteam/teamunlock/unlock <teamname> - "Unlocks" <teamname>'s player count
				       to allow anyone to join the team.
	readyteam/teamready <teamname> - Readies all players on <teamname>
	unreadyteam/notreadyteam - Unreadies all players on <teamname>
	captain <teamname> <player_name> - With only the <teamname> parameter, lists
				 current <teamname>'s captain.  Adding the <player_name>
				 parameter transfers the <teamname>'s captain-ship to
				 <player_name>.
	kickplayer/remove <teamname> <player_name> - Removes <player_name> that is a
						     member of <teamname>.
	time/matchpause/timein - Allows referee to unpause a match that has been
				 put into "time-out" mode.  Referees cannot use
				 this command to call a timeout if they are not
				 also a team captain.  If the match needs to be
				 paused, the referee should use the "r_mpause"
				 command.



Client Variables:
-----------------
ngWorldStats from NetGames USA (http://www.netgamesusa.com) is a new
Internet-wide logging system that is used to track ALL events related
to a player when they play on an ngWorldStats-enabled server.  However,
to keep track of unique individuals, a requirement is needed from the
client to uniquely identify them from the rest of the game-playing world.
 
To ensure that a client's stats are not added into another player's stats
when one or more players are using the same name, the client can put the
following line in their autoexec.cfg file (or any startup script):

		set ngWorldStats_password my_special_password_string

The "my_special_password_string" is any sequence of characters and can be any
length in size.  It is *highly* recommended to use a string of at least eight
characters, but this is not a requirement.  ngWorldStats identifiers are based
on both the player's name and ngWorldStats_password string.  Thus, if a client
changes either their name or ngWorldStats_password string, then they will have
a different unique player within the ngWorldStats database.  Visit:

	http://Quake2.ngWorldStats.com/

for more information on ngWorldStats for Quake2.

Players can determine if a server is ngWorldStats-enabled by looking at the
severinfo variable "ngWorldStats_Status" on game browser utilities such as
GameSpy.  If the value of this variable is "*** ENABLED ***", then all events
will be sent to the main ngWorldStats collector sites.  A value of
"<<< Disabled >>>" means that no player stat information is being recorded to
the global ngWorldStats system.


There are two variables that have been set up that allow for clients to
automatically set their team preferences when they connect.  Note that this
is *only* in the team-play mode.  Also, both of the below variables must be
set in order for the client's preferences to be valid (and subsequently
used).

	default_teamname:
		Specifies the desired teamname to use.  If there is one team
		that is empty when a player enters the game from observer mode,
		the player will be added to that (empty) team and the teamname
		and teamskin will be chaged to the client's personal default
		values.  If there is already a team set up with the same name
		as the client's default_teamname, then the client will be added
		to that team when he/she enters the game.  Useful for rejoining
		teammates across level loads.

	default_teamskin:
		Specifies the default teamskin when starting a new team.

	default_joincode:
		Specifies the default joincode that is to be used for the team
		that the player is joining, if they join as captain.

It should be further noted that the client will have these variables
automatically set by the server if one of the three following conditions
occur:
	1. A client does NOT have these default_* values set when he/she joins
	   a team.
	2. The teamname of the team that the client is a member of is changed.
	3. The teamskin of the team that the client is a member of is changed. 

	Note: the default_joincode is *not* automatically sent to the client.

To allow a client to _join_ as a REFEREE in a match (any type), the client
must set the following variables before connecting to the server:

	ref_status:
		0 - Do NOT attempt to become a referee.
		1 - Client is attempting to be a referee.

	ref_passwd:
		Password set on the server for all referees.

Here, it is *required* that both of the above variables are set correctly
before connecting.  If successful, the client will have all referee commands
available (in addition to regualr client commands).  However, the referee is
NEVER allowed to enter the match (i.e. play and kill people) at any point in
time.  If the referee wants to play, he/she must reconnect with ref_status
set to 0.

Note that this status is a bit different than when clients enable referee
status while playing.  The above-described format was designed primarily
for referees at a LAN tournament, where they must ref several (many) matches
throughout the tourney.  Rather than having to log in to each server and
setting up parameters, they can do it all in their autoexec.cfg before
connecting to a server.  It also gives them a safeguard from accidentally
entering a match and affecting gameplay.