This mutator Kicks Idle players to allow room for active players to connect to your server.
---------------------------------------------------
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 are an Admin.
It will not consider you idle if you have an artifact.
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 KickIdlersU2XMPV1.1 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 KickIdlersU2XMPV1.1 - KickIdlersU2XMPV1.1 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 U2XMP's System Folder
KickIdlersU2XMPV11.u
KickIdlersU2XMPV11.int
IMPORTANT!
If you do not do this U2 XMPs package validator will boot all players at the start of each new level.
After copying the files to your U2XMP's System Folder. Execute the BuildMD5.bat file to update the server's default MD5 checksums to include the checksums of KickIdlersU2XMPV1.1.
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=KickIdlersU2XMPV11.KickIdlers
The resulting command will look something like this.
ucc server XMP-Alcazar?mutator=KickIdlersU2XMPV11.KickIdlers ini=U2XMP.ini -log=server.log
If you are using mutliple mutators, the resulting command will look something like this.
ucc server XMP-Alcazar?mutator=Mutator1.Mutator1,KickIdlersXMP-Alcazar?.KickIdlers ini=U2XMP.ini -log=server.log
Add a ServerPackages=KickIdlersU2XMPV11 to the [Engine.GameEngine] section of your Server's U2XMP.ini file.
---------------------------------------------------
Server Customization:
The Server Admin can configure KickIdlersU2XMPV1.1 with the following options in the Server's U2XMP.ini file
[KickIdlersU2XMPV11.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 KickIdlersU2XMPV1.1 to kick players when the server is full, or when it isn't.
ShutDownAfterGame= [True | False] flag to disable KickIdlersU2XMPV1.1 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 some mod game types that KickIdlersU2XMPV1.1 may think have ended when they didn't, could be created.
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.
---------------------------------------------------
User Localization:
Users can configure the language of the KickIdlersU2XMPV1.1 on screen messages in thier KickIdlersU2XMPV11.int file
or
KickIdlersU2XMPV11.det KickIdlersU2XMPV11.est KickIdlersU2XMPV11.frt KickIdlersU2XMPV11.itt KickIdlersU2XMPV11.kot etc...
These are the default messages and contents of a user's KickIdlersU2XMPV11.int file.
[KickIdlersMsg] Msg0="You have been kicked for not playing!" Msg1="Start playing or be KICKED!!!" Msg2="Start playing or you may be KICKED!!!" Msg3="used the ShowIdlers command!" Msg4="used the ShowIdlers command! Prepare to be kicked!" Msg5="You have been kicked!" Msg6_1="By" Msg6_2="for not playing!" Msg7_1="has been kicked by" Msg7_2="'s KickIdlers command, for not playing" Msg8="Type Mutate ShowIdlers (or ShowSlackers) to show, or Mutate KickIdlers to KICK, the people who aren't playing." Msg9="Type Mutate ShowIdlers to show, or Mutate KickIdlers to KICK, the people who aren't playing." Msg10="Type Mutate ShowIdlers (or ShowSlackers) to list the people who aren't playing." Msg11="Type Mutate ShowIdlers to list the people who aren't playing." Msg12_1="has been kicked by the KickIdlers mutator for not playing for" Msg12_2="Seconds" Msg13="There is an idle player! Type Mutate KickIdlers to kick the idle player." Msg14_1="There are" Msg14_2="idle players. Type Mutate KickIdlers to kick them." Msg15="There is an idle player!" Msg16_1="There are" Msg16_2="idle players."
---------------------------------------------------
Files contained in this ZIP file:
KickIdlersU2XMPV11.txt
KickIdlersU2XMPV11.u.uz2
KickIdlersU2XMPV11.u
KickIdlersU2XMPV11.int
---------------------------------------------------
If you have problems with this, let me know at GameServerAdmin@OHNOSoftware.com
TheCatcher