NickNameBan v1.10

Introduction:

Since in UnrealTournament'99 is no way to identify a player by a unique hash ID like in UT2004, I thought a mutator which kicks players off a server when using a unwanted nick name or tag will be a usfull addition to UT. So, here you go.

Have fun!
+++crowbar+++
e-mail: crowbar666@gmx.net

Features:

  1. Keep unwanted players off the server by nick name.
  2. Stores IP or IP-range (C- or B-class subnets) and kicks lamer off the server when reconnecting with an other nick name.
  3. Protects your clans tag form abusive use through players, who are not in your clan by kicking them off the server.

Change Log:

v1.10:

  • [Added]: IP range can now be configured for B- or C-class subnets.
  • [Added]: Clan tag protection.
  • [Fixed]: minor bugs fixed.

v1.00:

  • Initial release.

Installation:

  1. Unpack all files and copy them into the "system" folder of your UnrealTournament installation.
  2. Add the following line to your server ini under the [Engine.GameEngine] section (needs to be done, when you want to use console commands):
    ServerPackages=NickNameBan110
  3. Edit the NickNameBan110.ini to suite your needs.
  4. Start the server with ucc like listed below.

Start with ucc on Linux-server:

./ucc-bin server DM-1on1-DavidM?game=Botpack.TeamGamePlus?Mutator=NickNameBan110.NickNameBan110 Port=22900 Multihome=172.22.142.100 -nohomedir ini=server.ini log=server.log

Start with ucc on Windows-server:

ucc server DM-1on1-DavidM?game=Botpack.TeamGamePlus?Mutator=NickNameBan110.NickNameBan110 Port=22900 Multihome=172.22.142.100 -nohomedir ini=server.ini log=server.log

Note:
Change "Multihome" and "Port" to the IP-address and the port for ut of your server. The ini-file of your server should not be edited to make this mutator work, except you want to use the command line option.

Configuration:

EnableKickByNick
Setting value to true enables mutator, false disables mutator. Default = True.

EnableKickByTag
When you want to keep a whole clan from joining your server set value to true.

ExplicitNick
The nick name of the player has to exactly fit the name in the list, when the lamer is to be kicked. Setting value to false will kick the player when a part of the nick name fits, e.g. if bad nick is "lamp" player with nick name "schlampe" or "lampedusa" will be kicked. Default = True.

KickByNickMsg, KickByProtectedTagMsg
Dont have to explain these, huh?

UseIPRange
When value set to true, the IP-range like 123.123.123.* will be used instead of the exact IP, like 123.123.123.123 to keep a lamer from joining the server. The subnet class is defined by the parameter UseIPClassB.
Default = True.

UseIPClassB
If this value is set to TRUE, the subnet class B (123.123.xxx.xxx) is used, when using UseIPRage feature. If the value is set to false, the subnet class C (123.123.123.xxx) is used. Be carefull with this parameter. When using B-class subnets all users will be kicked with IP numbers for example from 123.123.1.1 to 123.123.255.255 = more than 60.000 IP numbers!!!
Default = False

bLogging
Enables logging to server log file. Default = True.

BadNick[]
Here you can add your lamers nick name ;-) Max. amount in this version is 256.

BadNickIP[]
When a lamer tried to connect to your server and got kicked, his IP address or IP-range and nick name will be stored in this array. Dont change it. When list is full, NickNameBan will start at first position again and will overwrite old entries, since NickNameBan shall not be used for IP banning. This belongs to UT:

Example file entries:
BadNickIP[0]=192.168.0. Test
BadNickIP[1]=127.0.0. Player1
BadNickIP[2]=
BadNickIP[3]=
....

BadTag[]
Here you can add your lamers tag ;-) Max. amount in this version is 64.

bProtectTag
Enable tag protection.

sProtectedTag[], sProtectedNicks[]
With sProtectedTag you can protect up to 8 clan tags, e.g. [foo]. With sProtectedNicks you can defined the nick names that are allowed after your tag prefix. Example:

sProtectedTag[0]=[foo]
sProtectedNicks[0]=bar
sProtectedNicks[1]=foo

Now, with this example, every player with the tag (e.g. [foo]lamer) will be kicked from the server, if his nick name is not [foo]bar or [foo]foo.

IPIndex
Dont change this value.

Console commands:

Open the console and login as a server administrator.

Next, type into the console (without the quotation marks):

  • "mutate nicknameban" or "mutate nnb"

What you see is a list of available commands to modify the mutator functions. This is important, because the console commands dont match the parameter names. To see, which configuration is actually set on the server, type:

  • "mutate nicknameban" or "mutate nnb"

To change a configuration parameter value, e.g. activate or deactivate the mutator, type:

  • "mutate nicknameban enablekick on" or "mutate nnb enablekick off"

AddNick / RemoveNick / RemoveAllNicks
These console commands are used to add or remove nick names to the list of banned nick names. Usage:

  • mutate nnb addnick test
    This command line will add the nick name "test" to the list of banned nick names.
  • mutate nnb removenick test
    This command line will remove the nick name "test" ...
  • ...

It's recommended to clear the IP list from time to time by using the "clearIP" command.

 
Copyright notice:

Use at your own will and risk.