=====================
Hostname Ban
FOR : UT 436-440-451 Windows/Linux >DEDICATED< Servers
Version 1.20 - July, 2006
Created By MSuLL
WebSite: http://www.atomicunreal.com/msull/
=====================

Installation
==============
* This mod requires the IpToCountry mod ( [es]Rush - 2006 ) be installed!
http://www.unrealadmin.org/forums/showthread.php?t=13122

Shutdown your server and open your server's configuration INI file
(usually UnrealTournament.ini or System.ini)

Find the section:
[Engine.GameEngine]

Add to ServerActors list:
ServerActors=HostnameBan.HostnameBan
* NOTE *  -  It must be BELOW IpToCountry's actor!



Getting Started
=================
Hostname Ban, by default, stores settings in "HostnameBan.ini"
Some admins will want to store settings in their server's ini.
To do this, open your server's ini and add the following sections:

[HostnameBan.HostnameBan]
bUseSystemIni=True

[HostnameBan.HBConfigExt]
SemiPassword=
bAnnounceKicks=False
BannedMessage=You are banned from this server!
HostnamePolicies[0]=ACCEPT,*


Now is the time to edit your configuration (I suggest that
you read this section all the way through first though).

Open your ini and refer to the configuration section below.
Once finished, start your server back up.


There are a ton of mutate commands, but the three you need
to know are:

mutate hb
mutate hb check
mutate hb login

'mutate hb' will bring up the help menu and explain all commands
'mutate check' will re-check all players against the policy list.  Use
this if you have made changes to the policy since players joined.
For instance if you ban a player's host and then perform the 'check'
command, they will be kicked immediately.  Otherwise they wouldn't be
kicked until the start of the next match.

'mutate hb login xxxx' will give a player with the password access
to Hostname Ban's admin features (nothing else, just Hostname Ban's).
xxxx needs to be replaced by your 'SemiPassword'.  If SemiPassword
is blank, the login system will be disabled.




Configuration
===============
SemiPassword=
- To configure this mod, you must be logged in as admin, or you can do
mutate hb login xxxx (xxxx being the value of SemiPassword).  This is
good for giving out to semi-admins.

bAnnounceKicks=
- Announce to players when a banned player is kicked off the server?

BannedMessage=
- Message to send to banned players if they attempt to connect to your server


HostnamePolicies[i]=
- Hostname policy list.
To ban a policy, use: DENY,host (where host is the player's hostname)
To accept a policy, use: ACCEPT,host

When banning you can use the masks '*' and '?'
'*' means "any number characters" and '?' means "only one character

DENY,*.comcast.net would block all players from host comcast.net
(did you notice the '*')

DENY,117-141-13-?.comcast.net would block all players that had
the host 117-141-13-, then any character, then .comcast.net


For instance:
DENY,mik?.domain.com would block mike.domain.com
and miki.domain.com, but NOT mikie.domain.com

DENY,mike.*.com would block mike.domain.com
and mike.aol.com, but NOT joe.domain.com




For WebAdmin Installation
============================
Hostname Ban comes with a webadmin interface so that you can
change things without having to hassle with mutate commands
from in-game or having to edit your INI files manually.

Now find the section:
[UWeb.WebServer]

Add:
Applications[n]=HostnameBan.HBWeb
ApplicationPaths[n]=/HostnameBan

...where [n] is the next on the list ([2] or [3] etc)

If you've done this right, start up your server and browse to (note caps!):

        http://<server_ip>:<port>/HostnameBan

Use the UT WebAdmin username and password when prompted. If the Hostname Ban
options screen comes up, it's working; an error message or nothing
at all means something has gone very wrong (you messed up).




Changelog
===========
----------------
| Version 1.20 |
----------------
(First Official Release)
- [Added] WebAdmin interface
- [Added] Extra protection against invalid entries
- [Added] 'check' command

----------------
| Version 1.10 |
----------------
(First Public Beta)
- [Added] 'mutate' commands

----------------
| Version 1.0 |
----------------
(First Private Beta)






+-------------+
|  Thanks To  |
+-------------+
- PurplePants: For OPBan, which I used a lot as a
reference while making the WebAdmin interface.

- [es]Rush: For creating IpToCountry, the backbone
of this mod.

- {SDA}Baiter: For beta testing and feedback.

- lism: He was the one who first proposed this idea.

- |KOA|The_Dave: For servers to test on, a website,
and a lot of support for all this time!

- Azazel: For the hosting of UnrealAdmin.org,
which is my little base of operations.


----------------
| MSuLL - 2006 |
----------------