EF Admin

==============================
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
ELITE FORCE ADMINISTRATION MOD
Version 1.7.0
Build Date: 12-31-06
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
===============================

=============================================================
EFADMIN Homepage	: http://www.beer-garden.org
Contact Email		: [email protected]
=============================================================
Author: Shafe -- http://www.beer-garden.org


=============================================================
OVERVIEW
=============================================================
This mod fixes a few bugs in EF, offers admins a bit more control, and offers some extended voting options in EF.

While many other mods offer some of the same functions, this mod is 100% server side only meaning no downloading for the clients.  This mod also doesn't offer any 'clan advertisements' or annoying credit lines at game start or when a player enters the game, it runs transparently.

If left at the default settings, the mod will operate as EF Normally does (excluding a few fixes), and will only offer extended admin capabilities.




=============================================================
Quick Overview Of Features
	HIGHLIGHTS
=============================================================
Most servers keep voting turned off as voting will bring a map rotation to a grinding halt. This mod allows you to define what can and can't be voted on, for example you may disable map votes, while offering voting on various other aspects of game.

Bots are a bit smarter ;)

INVISIBLE PLAYER BUG.. fixed.

Disable/Enable any given class in specialties mode.

The ability to enable rifle jumping in disintegration mode.

Adjust the rate of fire in Disintegration Mode

Team Balance - Rcon Command Which Will Balance The Teams For You, Can also be voted on.

Disable Chat Fragging Completey!

Chat Filtering:  Block curse words or other words of your choosing on your game server.

Bad Names List: automatically kick players who go under certain names.

Mute / Unmute: Disruptive Players

Set the maximum number of players per team.  This is good for match configurations or 1v1 servers.

Message Of The Day Feature.

Optional Rule Violation System, a system that allows you to define what isn't allowed on the server such as foul language, console spamming, chat fragging etc.  The system will offer warnings.. Then mute the player for 30 seconds, then if the player continues to break the rules, they will automatically be kicked.

New Game Type! One For All.

Vector Math Updated for Compatability with IOSTVEF 1.3x Patch.


=============
NEW IN 1.7.0
=============
This is mainly a bug fix, while I'm working on v2.

The main reason for this release was to get qvm's out there that ensure compatibility with the 1.37 patch.  Patched clients on servers (patched or unpatched) with the older version of EFAdmin will encounter problems jumping out of trenches.  This release is mainly to address that.  

There are some other new things though worth noting.

- Fixed the Voting System.  EF has always had problems with voting breaking map rotations.  No longer, vote for a map, map_restart or nextmap and it'll pickup the rotation where it left off.

- Fixed Bug Where the Flags Would Occasionally Disappear, when g_tkdetpack was set to 1.

- Bots can now rocket jump.  Raven's original code was written so bots would try to rocket jump with the stasis weapon... *cough*, to enable set g_UseBotAI to 1

- Bots can now use detpacks, somewhat intelligently even, to enable set g_UseBotAI to 1

A full list of fixes is in the readme, there are a few new cvars documented.  Version 2.0 is quite different and there will be beta versions available shortly.  Keep tabs on the project @ http://dev.beer-garden.org

Cheers
Shafe

=============================================================
FIXES
=============================================================
- Voting now works.  Vote on a map.. and the rotation continues afterwards.
- The Dreaded Invisible Player Bug Corrected
- Bots on a password protected server will no longer crash the server.
- Force Fields no longer will extend higher than they should..
- Fixed The maximum number of votes you may call in the original code.. added in a cvar to let you adjust that number.
- Podium Fixes.. No more Spectators as MVPs.
- New 'status2' command will not cut off the status listing when there are a lot of players on the server.  
- Bot_Minplayers now kicks bots by client number instead of bot name. This way if a bot name jurot is kicked, players with the same name will not be kicked.
- Corrected the bug where sometimes a bot lingers around as a spectator.
- Created a cvar that allows you to disable the annoying long weapon respawn times in Team DM.








=============================================================
UPGRADING FROM AN EARLIER VERSION
=============================================================
If you are already using an earlier version of EFAdmin, you can simply replace the qagame.qvm file located in your /EFAdmin/vm folder with the one in this archive.





=============================================================
INSTALLATION
=============================================================
Extract this zip file to your main ST Voyager folder.  If done correctly it will automatcally create a /EFAdmin/vm/ folder *OR* you can manually place the files in the correct places.  To do this create a folder off of your main Elite Force directory (NOT YOUR BaseEF) called EFAdmin.
Inside this directory create a folder called 'vm' and copy the QAGAME.QVM file into it.

The path would look something like this:
\YOUR_EliteForceDir\EFAdmin\vm\qagame.qvm

On linux it would look something like:
/stvef/EFAdmin/vm/qagame.qvm

Add the following to your server startup command line.
+set fs_game EFAdmin +exec MyConfigFile.cfg

Included in the zip file is an example configuration file called efadmin.cfg.  You may modify this file to meet your needs either include it in your configuration file or use the 'exec' command to run it (i.e. exec efadmin.cfg)





=============================================================
RCON Commands
=============================================================
mute <player>
disables the display of chat messages from given player. You may use the players name or client number.  All Color Codes are ignored.

qmute <player>
QuickMute... disables the display of chat messages from given player for 35 seconds.  After 35 seconds the player will be UNMUTEd automatically. You may use the players name or client number.  All Color Codes are ignored.

unmute <player>
enables the display of chat messages from given player. You may use the players name or client number.  All Color Codes are ignored.

timeout <player>
Puts a disruptive player in timeout (spectator mode) and wont let them re-join for
30 seconds. You may use the players name or client number.  All Color Codes are ignored.

balanceteams 
If a team has 2 or more players then the opposing team, this command will look for people with 0 points first, then pick someone at random to move to the team with fewer players. 
PLAYERS NOW GET TO KEEP THEIR SCORE IF THEY ARE SWITCHED

g_say "<<message>>"
Displays Message in middle of screen to all players

status2
An alternative to the internal status command.  There are problems with the internal status command when there are a lot of players on a server.  You'll find that the status command only gives you a partial listing of the players due to the internal buffer size limitation in the quake III engine.  This command will offer you all the status information regardless of how many players are in the server.  This also evades an exploit in the internal status command that allows players NOT to be listed by changing their name to an odd combination of ASCII CHAR codes.

kickbots
kicks all bots on the server.

returnflags
Returns both flags to base

returnflagred
Returns the red flag back to the base.

returnflagblue
Returns the blue flag back to the base


=============================================================
CLIENT SIDE COMMANDS
=============================================================
votehelp
Offers an explanation of all enabled voting options.

help
offers a list of available client commands.

efver
offers current version and build information on the EFAdmin mod itself.