                                PermaBan v1.3
                          Written by: ChimChim[tSr]
                      e-mail: tribes@quickthrottle.com

Sorry for the weak documentation but this should get you through the install
and implementation.  Most of all, please excuse any spelling errors in this
document as I am whipping this up as fast as possible and not doing any spell
checking! :-)


PLEASE DO THE FOLLOWING
-----------------------

I provide this mod free of charge although I consider the code my property.
For payment, all I ask for is that you mention in your Message of the Day
message that you are running PERMABAN v1.3!!  I will soon have a web site
where you can go to get updates and news.  I prefer not to FORCE this message
to occure on your server and rely on you to post that information.  Please
do so, it also serves as a warning to potential troublemakers!


INTSTALLATION
-------------

Create a directory in your tribes root directory called permaban, install the
scripts.vol file there.  In your ..tribes/config folder, install the permaban
info file called permaban.cs.

On your commandline for your server startup icon add the following:
        - mod permaban

You should now be installed!


VARIABLES
---------

$PermaBan::IP[..] - These contain the banned IP's.
$PermaBan::AllowAdminVote - 0 means users cannot vote others as admin.
$PermaBan::BanMessage - This is the message displayed when a banned user trys
                        to get into your system.
$PermaBan::KickMessage - This is the message displayed when the user is
                         initially banned from the system.
$PermaBan::IPCount - A internally used variable.


OPERATION
---------

When you assign yourself as adming when playing the game (by issuing the SAD
command), all you have to do it hit TAB and you will get a list of all of the
players in the game.  Simply click on the user and on option 3, you will be
given the option to PermaBan the user.  Upon selection of that option, you
will then be asked to confirm the action.  Boom, that is it.  The user is
kicked, the message is given and the IP database is updated.

If you are telnetted into the server for remote administration, you will need
to get the clientId of the user you want to permaban.  Issue a listplayers();
command to list all of the players.  When you get the ID of the user, issue
the following command: permaban::banip(clientId,"adminpassword");  For example
say the admin password is killme and the clientId is 2050:

                permaban::banip(2050,"killme");

This is the same as using the menu option in the game.


BUG REPORTS / SUGGESTIONS
-------------------------


Bugs - Please e-mail me at tribes@quickthrottle.com.  Describe FULLY what
you are experiencing.

Suggestions - E-Mail me at the before mentioned address.  Please limit the
suggestions to things that benefit administration of a Tribes Server.  I am
not and will not be doing any weapon, vehicle, etc. type mods.


CONCLUSION
----------

Thank you for your interest in this mod.  I hope it serves you well.


DISCLAIMER
----------

By using this software you are assuming ALL responsibility.  I make no
guarantees as to its fitness and ability to function.  This is provided as
as a service to you.  If this fails to run, cause damage of any kind, I will
not be held liable.  In essence, YOU ARE ON YOUR OWN.


                        (c)1999 - StupaFresh Software
