KickIdlersV2a 

This can be downloaded from http://CTCRClan.com/UTZips

This mutator Kicks Idle players to allow room for active players to connect to your server.

It was originally, loosly based on the KickIdlePlayers.u mutator.


---------------------------------------------------
It has the following features.

It will not consider you idle if you change which direction you are looking (up, down, right, or left).

It will not consider you idle if you move (even by strafing).

It will not consider you idle if you fire a weapon (alt fire or primary fire).

It will not consider you idle if you are an Admin.

It will not consider you idle if you have the flag.

It supports player commands to view the idle players and can be configured by the server admin to allow players to kick idle players.

It is Admin configurable to not kick idle players unless the server is full (or a player issues the Mutate KickIdlers command).  It defaults to only kicking idle players if the server is full.

It is Admin configurable to shut itself down (or not) at the end of the game - so players won't be kicked during end of game activities (like map voting).  It defaults to shuting itself down at the end of the game.

It is Admin configurable so that if there are one or more idle players on the server, it will send a message every minute informing everyone on the server how many idle players there are.  And a message every 4 minutes informing the users how to determine who the idle players are.  And if the Admin has configured KickIdlersV2 to allow players to kick idle players then it will also tell players how to kick the idle players.

It is Admin configurable to allow players to kick all idle players.

When an idle player (or players) is kicked by KickIdlersV2 - KickIdlersV2 will inform everyone else on the server which player(s) has been kicked for being idle, how long the idle player(s) was idle, if applicable it will say who issued the Mutate KickIdlers command.


Since it doesn't kick idle players automatically, unless the server is full.  It has 3 commands to allow the other players to see who the idle players are and how long they have been idle.  And to allow the other players to kick the idle players from the server.

Mutate ShowSlackers - Will display a list of all the players that are on their way to becoming idle (have been idle for at least 1/2 of the Kick Time) and how long they have been idle.

Mutate ShowIdlers - Will display a list of all the idle players and how long they have been idle.  It will also send a warning to all the idle players telling them which player has just issued the Mutate ShowIdlers command.  And if the Server Admin has allowed players to kick Idle Players - it will warn the idle player that they are probably about to be kicked.

Mutate KickIdlers - Will kick ALL the idle players.  It will tell the players being kicked who kicked them, and how long they were idle.  It will also tell all the other players who kicked the idle players and how long each one was idle.


---------------------------------------------------
Installation Instructions:

Copy the following files to your UnrealTournament's System Floder

KickIdlersV2a.u
KickIdlersV2a.int
KickIdlers.ini

To use this on a server (I don't know why anyone would run this in a single player game) add the following to your UCC.exe startup line.

?mutator=KickIdlersV2a.KickIdlers

The resulting command will look something like this.

ucc server CTF-DiamondSword.unr?game=Botpack.CTFGame?mutator=KickIdlersV2a.KickIdlers ini=UnrealTournament.ini -log=server.log

If you are using mutliple mutators, the resulting command will look something like this.

ucc server CTF-DiamondSword.unr?game=Botpack.CTFGame?mutator=Boden.KeepItClean,KickIdlersV2.KickIdlers,BDBMapVote302.BDBMapVote,AntiShockHoB2.AntiShockHoB2,CTTree2y.CTTMutator ini=UnrealTournament.ini -log=server.log

Add a ServerPackages=KickIdlersV2a to the [Engine.GameEngine] section of your Server's UnrealTournament.ini file.

---------------------------------------------------
Customization:
The Server Admin can configure KickIdlersV2a with the following options in the Server's KickIdlers.ini file

[KickIdlersV2a.KickIdlers]
KickTime=300
OnlyKickWhenFull=True
ShutDownAfterGame=True
AllowKickIdlersCommand=True
AllowShowSlackersCommand=True
Advertise=True

KickTime= [seconds] till an idle player is considered an idler.

OnlyKickWHenFull= [True | False] flag that allows the Server Admin to configure KickIdlersV2 to kick players when the server is full, or when it isn't.

ShutDownAfterGame= [True | False] flag to disable KickIdlersV2 after the game ends p this will keep it from kicking players during map voting.  The reason I allowed this to be configurable is because there is a possibility that there are some mod game types that KickIdlersV2 may think have ended when they didn't.

AllowKickIdlersCommand= [True | False] flag allows the admin to decide if the other players on the server will have the right to use the Mutate KickIdlers command to kick the idle players.

AllowShowSlackersCommand= [True | False] flag allows the admin to decide if the other players on the server will have the right to use the Mutate ShowSlackers command to show the potential idle players.

Advertise= [True | False] flag that enables KickIdlers to broadcast the instructions on how to use it and display if there are any idle players currently on the server.  Currently it broadcasts it's instructions once every 4 minutes.  And it displays if there are any idlers once every minute.


---------------------------------------------------
In Game Customization:
The Server Admin can interogate KickIdlersV2a's configuration with the following in-game commands

admin get KickIdlersV2a.KickIdlers KickTime
admin get KickIdlersV2a.KickIdlers OnlyKickWhenFull
admin get KickIdlersV2a.KickIdlers ShutDownAfterGame
admin get KickIdlersV2a.KickIdlers AllowKickIdlersCommand
admin get KickIdlersV2a.KickIdlers AllowShowSlackersCommand
admin get KickIdlersV2a.KickIdlers Advertise

The Server Admin can configure KickIdlersV2a's configuration with the following in-game commands

admin set KickIdlersV2a.KickIdlers KickTime 300
admin set KickIdlersV2a.KickIdlers OnlyKickWhenFull True
admin set KickIdlersV2a.KickIdlers ShutDownAfterGame True
admin set KickIdlersV2a.KickIdlers AllowKickIdlersCommand True
admin set KickIdlersV2a.KickIdlers AllowShowSlackersCommand True
admin set KickIdlersV2a.KickIdlers Advertise True


---------------------------------------------------
KickIdlersV2b adds the following feature KickeIdlersV2a

1.  In team based games, the players team is listed in the output of the Mutate ShowSlackers and the Mutate ShowIdlers commands.


---------------------------------------------------
KickIdlersV2a adds the following features KickeIdlersV2

1.  The Mutate ShowSlackers command.

2.  Added AllowShowSlackersCommand so that the admin can disable Mutate ShowSlackers.

3.  Changes the advertising of the instructions to once every 4 minutes (beginning on the first minute mark).

4.  KickIdlers now saves it's configuration parameters to the KickIdlers.ini file after every game.


---------------------------------------------------
KickIdlersV2 fixes the following 4 bugs in KickeIdlersV1 (and adds a lot of features):

1.  Kicked idle Admins.

2.  Considered people idle even if they were strafing.

3.  Could kick people during end of game activities (ie. Map Voting).

4.  Kicked people when the server wasn't full.


---------------------------------------------------
Files contained in this ZIP file:

KickIdlersV2a.txt
KickIdlersV2a.u
KickIdlersV2a.u.uz
KickIdlersV2a.int
KickIdlers.ini


---------------------------------------------------
If you have problems with this, let me know at GameServerAdmin@OHNOSoftware.com

TheCatcher


