Chat Vote Kick 1.20
by Barbarian
http://barb4rian.tripod.com/
August 3, 2003.

Type !help in team or general chat for usage information.  The script traps the command and doesn't send it to the server if it's a valid command.

Commands have changes since version 1.01, see below.  

To install extract with folders enabled to c:\Dynamix\Tribes2\Gamedata\base.  Requires support.vl2 from http://scripts.tribalwar.com/uberguy 

The short version:
------------------

!kick <name> to kick someone/vote kick someone.  quite useful when someone is flooding the server and the lobbygui doesn't work

!help to get a list of commands

wildcards work in usernames


Commands:
---------

!help	Gives general help info

!help <command>	gives help on a command.  Commands are accessible with !command i.e. !kick.  Some commands are admin only:

any user:
	!kick <name> - kicks <name>, or votekicks if you're a regular user
	!info <name> - gets info on <name> (GUID etc)

admins only:
	!ban <name> - bans <name>
	!forceobs <name> - forces observer on <name>
	!forceswitch <name> - forces <name> to the team they're not on now
	!forceteam <1|2> <name> - change <name> to team 1 or 2
	!log [on|off] - turns logging on or off.  no parameter shows logging status


!help <category> gives help on a help category:
	version	- prints current version number
	wildcards - info on using wildcards in <name>'s
 	switches - /f - forces the command on multiple users.  place at end of command line.  # designates the rest of the line as a comment (for logging purposes)

	By default, the script does not operate on multiple players at once..i.e. !ban * will not ban the whole server, instead it will list the affected users and tell you to use the /f switch (if you really, really mean it).

	HOWEVER, if you add the /f (force) flag to the end of the line, it will work on multiple people.  Useful for clearing, say, a troublesome Tribe off your server. i.e. !kick *llamas* /f

	- Commands and <name> parameters are NOT case sensitive.  !KICK is the same as !kick and *llama* is the same as *LLAMA*

	- Tribe/clan tags are part of the user's name, so if someone is |asdfasdf|Llama *Llama and *adsfasdf* will match them.


Logging:
--------

By default the output of the kick, ban, info, forceobs, forceswitch, forceteam commands are logged to chatvotekicklog.txt in Tribes2\Gamedata\base.  Use !log off to turn this off or !log on to switch it on.


Wildcards:
----------

	* matches anything

	? matches one character of anything

Examples:
---------

!help kick
	Gives info on using the !kick command.

!kick Llama* would kick anyone whose name started with llama if he's the only player on the server who matches

!ban L?lama would ban L1ama (notice the 1 which in some fonts is hard to see) if he's the only player on the server who matches

!ban L?lama /f would ban L1ama and L2ama, since it uses the force command, and since ? matches any character in that position

!log on	turns logging on

Other Notes:
------------

	Due to Tribes 2 limitations, there is NO unban command.  You have to unban from the server console, or by editing the ban list on the server itself.  Don't ask me how, I don't run a server.



credits: 
--------

	jsut (! code)
	Julian Robichaux, for writing Pattermatch.java (wildcard matching code)
	people who tested this version

Revisions:
----------

1.20	Supports wildcards, many new commands.  rev. 1.01 command info no longer applies.
1.01	Oops, vote kick functions were dangerous if you were trying to kick a llama with a name like "e" or any short number of letters.  The old functions are still there if you want to use them, they are mvoteinfo and mvotekick, they get info on/try to vote kick anyone with the string you give in their name.  The new votekick and voteinfo require an exact name (minus clan tags, case insensitive).  If someone has a really long name, try !mvoteinfo to make sure !mvotekick is safe.
1.00	First version
