-------------------------------------------------------------------------------
  CCProtector 41
  A mutator for UT
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
  Original CCProtector by Dr.SiN
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
  Version 3.0 by TheCatcher - Forum: HTTP://www.CatchersCTF.com/Forum
-------------------------------------------------------------------------------
  Version 4.1 by Helen - www.birdieman.com
  
  Most of the work was originally done by Dr. SiN and TheCatcher.
  My updates include:
  - Players who do not belong to a team will get the spawn protection.
  - A charged impact hammer counts as the use of a weapon.
  - Option to specify whether the translocator is considered a weapon or not.
  I have incorporated my updates into the readme below, but again this was
  mostly provided by the previous two authors.

  - Use this version if you do not have either relics installed on the server.
-------------------------------------------------------------------------------




Spawn Protection (with a vengence):

CCProtector41 protects players from other players weapon fire for a limited time when they first spawn.

It does NOT protect players from themselves and it does NOT protect any armour that the player may have picked up. Players can still take damage from their own weapons, Lava, Fire, Caustic Elements, and Falling.

CCProtector41 uses 2 levels of protection. The first level of protection only deactivates after a specified period of time has elapsed, or the player picks up the flag. The second level of protection deactivates when a specified period of time has elapsed, the player fires, changes weapons, or picks up the flag. The protections are sequential. The first level of protection defaults to 2 seconds. The second level defaults to 15 seconds. This results in a default of 17 seconds of spawn protection (2 + 15). The length of time that each level of protection lasts is configurable by the Server Admin (MinGuardTime, GuardTime).

Players can identify other players that are spawn protected by the moving lines around their body (teleporter animations).

Players can identify when they are spawn protected by the same moving lines and by a countdown timer on their HUD indicating how many seconds of protection they have remaining. The color of the countdown timer also indicates which level of protection they are currently enjoying. The HUD countdown timer colors, location, HUD ID, and existance are configurable by each user (ProtectedColor, GuardedColor, ShowTimer, HUDID, HUDX, HUDY). The HUD countdown timer can be disabled by the Server Admin (ShowTimer).


Vengence:

The Server Admin can configure CCProtector41 to punish players that abuse the Spawn Protection. By default it is not configured to punish abusers of the Spawn Protection.

If a level 1 spawn protected player fires on another player, the player firing can have health taken away (ProtectedShooterPenalty).

If a player fires on spawn protected player, the player firing can have health taken away (ProtectedVictimPenalty).


CCProtector41 INI File Settings:

Server UnrealTournament.ini File Settings: [CCProtector41.CCProtector]

SETTING			DEFAULT	DESCRIPTION
MinGuardTime		2	Time in seconds that the player can not be hurt by other players unless the player picks up the flag. 
GuardTime		15	Time in seconds that the player can not be hurt by other players unless the player shoots, changes 										weapons, or picks up the flag. 
ShowTimer		TRUE	Display the amount of protection time remaining on the players hud. 
MGTWeaponsDisableGT     False   Weapon manipulation during MinGuardTime disables GuardTime.
TranslocatorIsWeapon	true	The translocator is considered a weapon, and if it is in the players hand it will disable GuardTime.
FlagCarrierCanSpawnKill True    Flag carrier can defend themselves against protected players.
ProtectedShooterPenalty	0	Amount of Health to deduct from shooters that are currently protected. 
ProtectedVictimPenalty	0	Amount of Health to deduct from shooters for shooting players that are currently protected. 
bLog			FALSE	Log Spawn Protection usage to the log file. 


Player CCProtector.ini File Settings: [CCProtector41.CCPHUD]

Setting Default Description 
ShowTimer	TRUE			Show the HUD of the amount of protection time remaining (only applicable if the server has also enabled ShowTimer). 
HUDID		Protected:		Spawn Protection Countdown timer HUD identifier. 
HUDX		0			Horizontal Location of Countdown Timer on screen (in percentage of screen width (0-100)).
					0 will place the Countdown Timer against the left edge of the screen; 50 will place it in the center; 100 will place it against the right edge; etc... 
HUDY		87			Vertical Location of Countdown Timer on screen (in percentage of screen Height (0-100)).
					0 will place the Countdown Timer against the top of the screen; 50 will place it in the center; 100 will place it against the bottom; etc... 
ProtectedColor	(R=0,G=255,B=0,A=0)	Color of Countdown Timer when NO ONE can hurt you, unless you pick up the flag. 
GuardedColor	(R=255,G=255,B=0,A=0)	Color of Countdown Timer when NO ONE can hurt you, unless you shoot, change weapons, or pick up the flag. 



Change History:

Flag to allow the Flag Carrier to kill Spawn Protected players.

Flag to allow the player to change guns during the MinGuardTime.

Allow the player to pick up ammo for the gun he is carrying without deactivating.

No longer de-activates when armour or other protective gear is picked up.

Only protects against other player's weapon fire, not environmental or self inflicted damage.

HUD display to indicate the type of protection and number of seconds remaining.

Vengence options to minimize abuse of the spawn protection.

V41 - Players without a team color are entitled to the spawn protection too!

V41 - charging an impact hammer counts as the use of a weapon.

V41 - option to count translocator as a weapon or not.


Installation:

CCProtector41
HTTP://www.birdieman.com/downloads/CCProtector40and41.zip


Copy CCProtector41.int, CCProtector.ini, and CCProtector41.u into your UT System folder. And select "CCProtection V41,0" as a mutator when you start a game.


Additional Server Installation Steps:

To run it on server, add the following to your UT INI file.

[Engine.GameEngine]
ServerPackages=CCProtector41

If you are running a dedicated server (via UCC). Add the following to your "?mutator=" command line switch

CCProtector41.CCProtector


Source:

Dr.SiN has given permission for the CCProtector code to be used by anyone for any purpose.
TheCatcher has given permission for the CCProtector code to be used by anyone for any purpose.

Helen also gives permission for anyone to use the CCProtector41 code for any purpose. Note that Helen may still be open to
providing updates, if you want an update, first try getting ahold of Helen by finding an email address at www.birdieman.com

The source required is found in the source folder.

Classes - contains the UTScript for CCProtector41

Textures - contains the bitmaps used for the protection graphics.


To recompile CCProtector.u:

1.  Copy the two additional folders (intact - including the folders) into a UT sub-folder called CCProtector41.
The resulting directory tree should look something like this:

C:\UnrealTournament
C:\UnrealTournament\CCProtector41
C:\UnrealTournament\CCProtector41\Classes
C:\UnrealTournament\CCProtector41\Textures

2.  Add the following line to the [Editor.EditorEngine]:

EditPackages=CCProtector41

3.  Remove CCProtector41.u from your UT System Folder.

4.  At a command prompt window, CD'ed into the UT System Folder Type

ucc make

There should now be a new CCProtector41.u file in your UT System Folder.<br>


If you wish to make an small update/fix to CCProtector41, call the next one CCProtector43.
If your change is more involved, call it CCProtector51.


To rename CCProtector41 to CCProtector43:

There are 3 steps to renaming a UT Mutator in the source code.

1. Rename the top level CCProtector41 folder to CCProtector43.

2. Rename the CCProtector41.int file to CCProtector43.int.

3. Change all occurances of CCProtector41 to CCProtector43 in the following locations.

 A. The CCProtector43\Classes folder UC files.

 B. The UnrealTournament.ini file.

 C. The CCProtector43.int file.

 D. The CCProtector.ini file.

