==========================================
Open Jedi Project Admin System Information
==========================================

$Revision: 1.11 $


========================
0000 - Table of Contents
========================

	0000..................Table of Contents
	0001..................Features
	0002..................Admin Cvars/Commands



===============
0001 - Features
===============

	A variety of new features designed to help game hosts effectively and fairly admin their servers.  The Admin System includes:


	Auto Team Balancer:
		This admin feature allows the server to automatically scan for team imbalance every 30 seconds.  If an imbalance is found, the newest player on the larger team will be switched to the other team.

		In addition, you can also have this system balance slightly unbalanced teams (like 6 vs 7) based on score.
		g_teamForceBalance controls this feature.
			0 = disabled
			1 = basejka g_teamForceBalance	
			2 = standard Auto Team Balancer scans.  
			3 = Auto Team Balancer scans with additional team balancing for score.
			4 = 3 + Human/Bot team balancing.  Keeps the bot/human ratio even on the teams.			


	Auto TK (team killers) kick/ban admin cvars:
			
		g_autoBanTKSpammers - Auto ban a player after this many team kills. 0 = no limit.
		g_autoKickTKSpammers - Auto kick a player after this many team kills. 0 = no limit.


	Auto Suicider kick/ban admin cvars:
			
		g_autoBanKillSpammers - Auto ban a player after this many suicides (/kill). 0 = no limit.  This cvar overrides g_autoKickKillSpammers if set.
		g_autoKickKillSpammers - Auto kick a player after this many suicides (/kill). 0 = no limit.  This cvar is overriden by g_autoBanKillSpammers (if set).


	Center Say:
		Added /centersay command to enable admins to print messages in the center of player's screens in nice big text.  Just treat this command like /say.
		
	Chat Spam Protection (ChatSpamProtection): 
		The chat channels are now protected against people spamming the channels, use ojp_chatProtectTime to set how often you can send chat messages.  0 = no limit.


	- Client IPs are now recorded to the game log whenever a client connects.  This is so admins can easily ban troublemakers after the fact.


	Expanded IP Banlist:  
		The IP banlist now uses an externally stored file (banip.txt) to ban certain IP addresses from the server.  You can use incomplete IPs (IE 192.246.40) to ban entire subnets.  Use the standard commands addip, removeip, and listip to use this feature.


	Expanded MOTD:
			This new feature allows server admins to send a message of the day to each client as they join the game.  These MOTDs are displayed in the center of the player's screen when they first join the server.  This MOTD is in addition to the MOTD displayed during map load.  The MOTD that is displayed can be based on weither or not the client is running the correct client.  See the descriptions for ojp_clientMOTD and ojp_MOTD.


	Team Kicking:  
		You can now kick members of your own team using the voting menu while in team gametypes.  Use g_allowTeamVote to toggle.  Team kicking works when normal voting is disabled.  The vote command ("/vote" or more specifically "/teamvote") and the yes/no menu options now apply to both team votes and general votes.  In terms of priority, team votes are voted on before general votes. Team votes are called using the "/callteamvote" or with "/vote if normal voting is disabled.


	Vote Control:
		Admins can now select which vote items they want players to be able to vote on.

		g_allowGametypeVote - Allow Gametype voting
		g_AllowMapVote - Control map votes
			2 = full map voting
			1 = map restart and next map votes only
			0 = no map votes
		g_AllowKickVote - Allow kick votes.  Note: This does not apply to the Team Kicking mentioned above.



===========================
0002 - Admin Cvars/Commands
===========================

	This is a complete list of all the cvars related to the new admin features.


	/centersay
	OJP, Multiplayer, Admin, Command 
	Description:
		/centersay, which is used just like /say, is used to print large, center-of-the-screen messages on all clients connected to the game.


	g_allowGametypeVote 1
	OJP, Multiplayer, Admin, Cvar
	Description:
		Allow Gametype voting


	g_AllowMapVote 1
	OJP, Multiplayer, Admin, Cvar
	Description:
		Controls map change voting
			2 = full map voting
			1 = map restart and next map votes only
			0 = no map votes
	

	g_AllowKickVote 1	
	OJP, Asteroids, Multiplayer, Admin, cvar
	Description:
		Allow kick votes.  Note: This does not apply to the Team Kicking mentioned above.


	g_allowTeamVote 1
	OJP, Asteroids, Multiplayer, Admin, cvar
	Description:
		Toggles the abilitiy to vote to of kick your own teammates.


	g_autoBanKillSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto ban a player after this many suicides (/kill). 0 = no limit.    This cvar overrides g_autoKickKillSpammers if set.


	g_autoBanTKSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto kick a player after this many team kills. 0 = no limit.  This cvar is overriden by g_autoBanKillSpammers (if set).
	

	g_autoKickKillSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto kick a player after this many suicides (/kill). 0 = no limit.	


	g_autoKickTKSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto IP bans TKs after this many team kills. 0 = no limit.


	ojp_chatProtectTime 1000
	OJP, Multiplayer, Admin, cvar

	Description:
		Sets how often a player can send text messages.  Time is in milliseconds.  0 = no limit.


	ojp_clientMOTD
	OJP, Multiplayer, Admin, cvar

	Description:
		This cvar contains a MOTD that is displayed in the center of the screen on every client that IS running the mod (or the correct version of it).

	
	ojp_MOTD
	OJP, Multiplayer, Admin, cvar

	Description:
		This cvar contains a MOTD that is displayed in the center of the screen on every client that ISN'T running the mod (or the correct version of it).


	g_teamForceBalance 0
	OJP, Multiplayer, Admin, cvar

	Description:
		Enabling this will make it so players can only join the team with the least number of players.

	OJP Changes (see Auto Team Balancer):
		0 = disabled
		1 = basejka g_teamForceBalance	
		2 = standard Auto Team Balancer scans.  
		3 = Auto Team Balancer scans with additional team balancing for score.


