MultiAdmin beta
===============

Features
--------
Welcome to multiAdmin !! 

This is a major, stable beta release of the multiAdmin server administration mod for Tribes 2.

Contained in this release of multiAdmin are:

Secure, automatic admin logging in 
4 levels of admin (there are a total of 6 but without the menu support the other 2 are useless) 
Multiple ways to set who your admins are 
Support for specially written plugins 
Fixes for a couple of bugs (notably the SADsetpassword one) 

Installation
------------
To install multiadmin, just unzip the multiAdmin zip file into your mod dir (ie /gamedata/base/ or /gamedata/tac/ etc). Then start your server.

Configuration
-------------
To configure multiAdmin, you need to edit the /base/prefs/admin.ini file. This file will look like this to start with:

[defaults]
special_vote_value = 3
all_admins_have_special_vote = true
always_append_admin_tag = true
use_global_password = false

[admin_clan]

[referee_clan]

[god_admin]

[minor_deity]

[referee]

[admin]

[special_voter]

[tks_only]

[never_admin]

You will need to alter some of these.

The 1st is special_vote_value. This is the number of votes the admin levels recieve. The default is 3. This means that when somebody who has the altered voting ability votes, their vote will count for 3 times more than usual. I suggest you don't set this much higher other wise you will effectively be giving people admin powers by letting votes they start always pass.

all_admins_have_special_vote. Ignore. Being removed. All Admin, Minor Diety and God admin levels will always have special voting privileges.

always_append_admin_tag. Set this to true and admins will always have the [admin] tag attached to their name to show people there are admins on the server.

use_global_password. This sets whether or not the old style admin passwords are used. If true, then people can still use SAD("server password to log in. HOWEVER, BECAUSE OF THE SECURE NATURE OF THE AUTOMATIC LOGIN PROCESS, THIS PASSWORD IS NO LONGER NECESSARY. In fact, passwords are the not very secure at all and I don't recommend setting this to true.

The next is the [admin_clan]. This is the complete name of a Tribes 2 clan that you can set up from within Tribes 2 to use to administer your server. You can list multiple clans here so a clan set up to specifically admin 1 server can also be given admin on other servers by adding a single line in this part.

For instance, if you have a server called w00t and you wish to set up a clan to administer this server, inside Tribes 2 you would go to the browser, click on Create Tribe, and then type in something like "w00t Admin" as the clans name. You can then list under [admin_clan] "w00t Admin". Now, whenever somebody in the "w00t Admin" clan joins the server, they will automatically be logged in at a level corresponding to their level within the clan. The levels are:

4   God admin
3   Minor deity
2   Admin
1   Special votes
0   TK only votes

NOTE: The Special votes and TK only votes only possess altered voting powers. THEY DO NOT HAVE ANY ADMIN RIGHTS AT ALL ON YOUR SERVER. Therefore, you can have a few hundred Special or TK only voters. The purpose of these 2 levels is to make it far easier to make certain things happen without an admin present ie kick a team killer.

[god_admin], [minor_deity], [referee], [admin], [special_voter], [tks_only], [never_admin]. These are the other way of setting who will automatically be logged in as an admin. Under each of these levels, you can list people/tribes using any of these tag/value pairs.

guid = <<Tribes 2 guid>>

name = <<Warriors main name>>

tribe = <<A clans/Tribes name>>

password = <<Password for this level>>

Heres an example:

[admin_clan]
tribe = w00t Admin

[god_admin]
guid = 54632
guid = 987
name = f34r

[minor_deity]
guid = 365254
guid = 219345

[referee]

[admin]
guid = 532239
name = his own ass
name = Bludgerr
name = S@dboi

[special_voter]
tribe = Uber Tribers
tribe = Freaks R Us
guid = 436576
guid = 87654
name = Peekaboo
name = SadSack

[tks_only]
tribe = Gods Of The Potty
tribe = Gods of Curry Revenge
tribe = Modems Suck
name = noddy
name = b00p b00p
name = ummmm_ghey

Plugins
-------
This beta ships with a few plugins. You can use any plugins or none. To remove a plugin simply delete the file or move it to somewhere outside of the Tribes2/gameData/ directory (don't leave it lying around in a sub dir of that one or it will still be used).

The first and most important is the TelnetHelper plugin. This makes it heaps easier to do things at the console or when you are using telnet. It provides a single command to do most of the things you need to do to a server. For instance you can change the password, map, admin someone, perma ban someone etc. Here's the list of stuff you can do with this plugin:

cmd (arg1, arg2, arg3, arg4, arg5);
     arg1 = admin : arg2 = client number : arg3 = admin level
     arg1 = teamnames : arg2 = team 1 name : arg3 = team 2 name
     arg1 = teamskin : arg2 = team 1 skin : arg3 = team 2 skin
     arg1 = password : arg2 = server password
     arg1 = stickypassword : arg2 = server password
     arg1 = timelimit : arg2 = time in minutes
     arg1 = tdOn
     arg1 = tdOff
     arg1 = map : arg2 = map name : arg3 = game type
     arg1 = mode : arg2 = tournament/ffa
     arg1 = tournymode
     arg1 = ffa
     arg1 = boot : arg2 = client number
     arg1 = ban : arg2 = client number
     arg1 = permaban : arg2 = client number
     arg1 = sayall : arg2 = message
     arg1 = sayteam : arg2 = team number : arg3 = message
     arg1 = sayplayer : arg2 = client number : arg3 = message

They're all straight forward. However, the sticky password means that any password set will stay even once the server is reset.

The 2nd is the clientCmd plugin. This allows clients to use the telnetHelper plugin. Permissions are set via the prefs file /plugins/prefs/clientCmdPrefs.ini. This plugin ONLY ALLOWS ADMINS access to the telnetHelper plugin so don't freak out about it.

There are quite a few more plugins in the works, however they won't be released until they're finished/relatively bug free.

Credits
-------
Writer - He wrote autoload.cs which I have simply renamed and done a find and replace on so that the plugins and the client side version occupy different name space. Well, there were a couple of other minor alterations.

The TAC Dev team - good bunch of blokes

The assorted TAC playing maniacs - Other people's idiotic obsessions are what keep us working to produce something like TAC 2 :o)
