UT2004 Ingame Admin Commands
----------------------------

What:
=====

Extends the admin toolset to allow you to do what you need to do to be able to admin a UT2004 server.

This is entirely separate from the Webadmin addin - xTitanWebAdmin. It's recommended but not necessary to use them together.


Who:
====

Written by Stephen "Piglet" C-E. Thanks to Shambler for helping an old dog learn new hax.
Contact: http://ut2004.titaninternet.co.uk/forums/private.php?do=newpm&u=6

Which Servers:
==============

This was written for servers using the XAdmin System, or the ServerExt Slotmanager running on top of Xadmin. 
Google for UT2004 Xadmin.AccessControlIni for more information on Xadmin.
If you use the basic admin system and have a very good reason not to use Xadmin style admin, then please let me know.

Commands:
=========
=========

Notes:
======

"playernameornumber" is either a player name or player number:

Player name can be 
	* = all players
	*name = players with playername ending in "name"
	name* = players with playername starting "name"
	*name* = players with playername containing "name"
	name = players with playername of "name"

Player number is the number shown from admin kick list.

Misc:
======

admin help (admin help deal) (admin help kick) 
- list out commands you can use

adminlogin silentusername password
- allows you to log in as admin without it being broadcast. There is no space between silent and the admin username.


Kick Commands:
==============

admin kick list
- List the players slot number for use in all other commands

admin kick playernameornumber {playernameornumber} "Your message"
- Kick one or more players with an optional reason.

admin kick session playernameornumber {playernameornumber} "Your message"
- Kick one or more players for the remainder of thre map with an optional reason.

admin kick ban playernameornumber {playernameornumber} "Your message"
- Ban one or more players indefinitely with an optional reason.


Commands to deal with a player:
===============================

admin deal list
- the same thing as admin kick list

admin deal say playernameornumber {playernameornumber} "Your message"
- send an unmissable message to one or more players

admin deal switch playernameornumber {playernameornumber} "Your message"
- force player(s) to swap to the other team - reason optional

admin deal kill playernameornumber {playernameornumber} "Your message"
- make player(s) suicide - reason optional

admin deal mute playernameornumber {playernameornumber} "Your message"
- make it impossible for player to use text chat - reason optional

admin deal unmute playernameornumber {playernameornumber} "Your message"
- make it possible for player to use text chat - reason optional

admin deal name playernameornumber newname
- rename a player - reason optional

admin deal spec playernameornumber
- when in spec mode, jump to spectating a particular player. In TAM you cannot spectate the other team while dead.

admin deal ready
- force player(s) ready

admin deal unready
- force player(s) unready

admin deal makespec
- force player(s) into spec slot if there is one

admin deal makeplay
- force spectator(s) into player slot if there is one

Commands to deal with the mute list:
====================================

These can be used whether or not the muted player is online

admin mutelist
- lists the mutes currently in force

admin mutedel n
- deletes the mute from position n in the list


How:
====

Installation:

1. Stop your server
2. Edit your server ini file:
	Within [Engine.GameInfo]
	Find: AccessControlClass=

	If you currently have: AccessControlClass=ServerExt.ReservedSlotsIni
		You are using ServerExt Slot manager, based on Xadmin Accesscontrol
		Comment it out: ;AccessControlClass=ServerExt.ReservedSlotsIni
		Insert: AccessControlClass=TitanAdminSM.TitanReservedSlotsIni

	If you currently have: AccessControlClass=XAdmin.AccessControlIni
		You are using Xadmin Accesscontrol
		Comment it out: ;AccessControlClass=XAdmin.AccessControlIni
		Insert: AccessControlClass=TitanAdmin.TitanAccessControlIni

3. Stick TitanAdmin.u or TitanAdminSM.u in your server's system directory - depending on number 2 above.
   It will not hurt to have both there - but only one will be used.

4. Restart your server after saving the ini.

ServerExt Notes:
================

If you want to move from Xadmin to Serverext slot manager, set up as per ServerExt instructions and then follow steps 1 to 4 above.
This code should be useable with future releases of ServerExt - but do test after each upgrade.


Version Control:
================

Version beta 0.2: Lots of new commands. Should be stable. TitanAdminSM is in use on all Titan servers.