NickNameBan v1.00

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 (e.g. 123.123.123.XXX) and kicks lamer off the server when reconnecting with an other nick name.

Change Log:

v1.00:

  • Initial release.

Installation:

  1. Unpack all files and copy them into the "system" folder of your UnrealTournament installation.
  2. Edit the NickNameBan.ini to suite your needs.
  3. Start the server with ucc like listed below.

Start with ucc on Linux-server:

./ucc-bin server DM-1on1-DavidM?game=Botpack.TeamGamePlus?Mutator=NickNameBan.NickNameBan 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=NickNameBan.NickNameBan 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.

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
Dont have to explain this one, 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. Default = True.

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.

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 list" or "mutate nnb list"

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.