---------------------------------------------------------------------
| CCProtector420 | a UT99 mutator | by Dr.SiN, TheCatcher, and Helen |
---------------------------------------------------------------------

CCProtector will protect players from other player's weapon fire for a limited time when they first spawn. 
This helps to prevent the game from being ruined by spawn campers.

You can tell when a player is spawn protected because they will have a 'teleport' animation around them.

You can set two distinct time durations that the protection lasts. One duration ensures protection, guaranteed. 
The other duration ensures protection up until the time the protected player starts using a weapon.

There are two kinds of health penalties you can include. One kind penalizes players for shooting protected players,
and the other kind penalizes the protected player for shooting non-protected players.

Note that protected players can still take damage from their own weapons, lava, fire, caustic elements, and falling.


| new for this version |

The main reason to use this version (instead of either 40 or 41) is that this version does not have any hassles about 
hat version of relics you may or may not have.


| the settings and what they mean |


MinGuardTime - This is the first level of protection. It only deactivates after a specified period of time has elapsed, 
or the player picks up the flag.

GuardTime - This is the second level of protection. It deactivates when a specified period of time has elapsed, the player 
fires, changes weapons, or picks up the flag.

These two protection times are sequential. Let's say for example you have set the Min Guard Time to 2 seconds, and the 
Guard Time to 10 seconds. So in this example, if the player did not fire or change weapons or pick up the flag, they
they would be guaranteed to be protected for a full 12 seconds (2 + 10).

ProtectedVictimPenalty - You can punish players who shoot at protected players. The number you specify here will be the amount of health that is taken away from the offending player.

ProtectedShooterPenalty - Likewise, you can penalize players who are protected if they think that they can get away with shooting unprotected players.

TranslocatorIsWeapon - This just allows you to indicate if you consider the translocator to be a weapon or not.

FlagCarrierCanSpawnKill - This gives you the option to allow the flag carrier to be able to shoot a protected player.

bLog - If true then various message will be written to the console log.


| accepted values |

MinGuardTime - greater than or equal to zero and less than 1000 (integers only)
GuardTime - greater than or equal to zero and less than 1000 (integers only)
ProtectedVictimPenalty - greater than or equal to zero and less than 199 (integers only)
ProtectedShooterPenalty - greater than or equal to zero and less than 199 (integers only)
TranslocatorIsWeapon - true or false
FlagCarrierCanSpawnKill - true or false
bLog - true or false


| adding the settings to the UnrealTournament.ini |

The settings need to be added to the UnrealTournament.ini file. Here is an example of what the section might look like that you need to add:

[CCProtector420.CCProtector]
MinGuardTime=2
GuardTime=10
FlagCarrierCanSpawnKill=true
ProtectedShooterPenalty=0
ProtectedVictimPenalty=0
TranslocatorIsWeapon=true
bLog=false


| running on a server |

If you wish to run this on a server, you will need to add this line to the [Engine.GameEngine] section of the UnrealTournament.ini file:

ServerPackages=CCProtector420


Then you can start it in one of two ways, command line or server actor:


| command line |

If your host allows you to edit the startup command line, here is an example that would include this mutator:

unrealtournament.exe DM-Codex?game=Botpack.DeathMatchPlus?MaxPlayers=16?mutator=CCProtector420.CCProtector -server

To specify more than one mutator, you just separate them with commas:

unrealtournament.exe DM-Codex?game=Botpack.DeathMatchPlus?MaxPlayers=16?mutator=medToggle210.medToggle,CCProtector420.CCProtector -server


| Server Actor |

Or you can start it just by adding this line to the [Engine.GameEngine] section of the UnrealTournament.ini file:

ServerActors=CCProtector420.CCProtectorActor


| Fin |

If you need more info, try http://www.birdieman.com/forum
