
     UTCOMP3 v2d readme.

	1. QUICK OVERVIEW.

Utcomp adds much useful game features and customization options into original UT3 gameplay.
Based on sources code of CustomUTv1b.
Short list of UTComp features you can see below:

   -Brightskins
   -Configurable teammate/enemy models
   -Hitsounds
   -Custom crosshairs
   -Advanced voting system
   -Custom player names
   -Lots of advanced settings and GUI improvements.

	2 COMPATIBILITY:
Tested on Unreal Tournament 3 v1.2, should work with version 1.1. Not compatible with v1.0.


	3. ADVANCED FEATURES OVERVIEW.
 3.1 Pause voting: 
	 Pause voting have own vote passed percentage, by default is PauseVotingPercentRequired=49. 
It mean, one player in duel or one full team in team gametype can set game pause. 
Also available admin console command "Mutate AdminPause" if pause voting blocked by server settings.


 3.2 Advanced voting settings:

Check "Enable Advanced Options" checkbox to enable options. Initial values is copy of current game settings. 
  
	* Duel/TDM Mod - Check to set standart duel and tdm settings such as force respawn, no redeemer,
, no darkwalker, no invulnerability in TDM, and additionally no doubledamage, no berserk and no invisibility for duel. This options work only in duel and tdm game mode.
Equal bEnableDuelTDmMod=True in config settings. Now Duel/TDM Mod not remove berserk and invis from TDM game.

	* 100%TeamDamage - Check to set full team damage. Equal bEnableFullTeamDamage=True in config settings.

	* NoSpawnProtection - Check to set no spawn protection. Equal bEnableNoSpawnProtection=True in config settings.

	* Armor Stacking - This checkbox permit pickup armor if a player has full load of same type armor.
Equal bEnableArmorStacking=True in config settings.

	* WeponStay - If UNCHECKED, turn weapon stay off, if checked, do nothing.
Equal bAllowWeaponStay=True in config settings.

	* TimeLimit - no comments.
	* MaxPlayers - no comments.
	* Max Spectators - currently disabled.
	* UnlimitedTransloc - check to add unlimited translocator charge.

	4. SERVERSIDE SETUP.
4.1  installation:
Unpack archive into "\My Documents\My Games\Unreal Tournament 3\UTGame\" under Windows or equivalent folder under Linux. 
To initialise UTComp on dedicated server add ?mutator=utcomp3v02d.UTMutator_utcomp3v02d in server commandline.


4.2  Quick reference of server config variables:

All server config settings are located in [utcomp3v02d.UTMutator_utcomp3v02d] part of UTutcomp3v02d.ini.

[utcomp3v02d.UTMutator_utcomp3v02d]

	Global voting settings:
bEnableVoting=True			
bEnableColorskinsVoting=True
bEnableHitsoundsVoting=True
benablewarmupVoting=True
bEnableGametypeVoting=True
bEnableAdvancedVotingOptions=True
bEnablePauseVoting=True
bEnableWarmup=True

	advanced voting settings:
bEnableDuelTDmMod=True
bAllowWeaponStay=True
bEnableNoSpawnProtection=False
bEnableArmorStacking=False
bEnableFullTeamDamage=False
bEnableUnlimitedTransloc=False

	internal voting settings: 
VotingPercentRequired=51.000000		Minimum  vote passed percentage
PauseVotingPercentRequired=49.000000	Minimum  pause voting passed percentage
VotingTimeLimit=30.000000		Voting time out


	Game types voting:			See chapter 4.3
VotingGametypes=... 			Examples of vote options

	UTcomp game settings:
bEnableColorskins=True			Allow players to use color skins and force model.
bEnableCustomNames=True			Allow custom nicknames.
MaxNameChanges=3			Maximum of allowed name changes.
bAlwaysAllowWeaponPickup=False		Players can get full ammo load when touching weaponrespawn and weaponstay is enabled.
bAnnounceMultiKills=True		Multikills will be broadcast announced.
AnnouncerLevel=0			Minimal multikill will be announced: 0=DoubleKills, 1 = MultiKills, 2 = MegaKills, 3 = UltraKills, 4 = MonsterKills
EnableHitSoundsMode=1			0 = HS disabled, 1 = Line of sight 2 = Always
WarmupTime=150				Warmup time
warmuphealth=199			Warmup players health
bPauseOnPlayerDisconnect=False		The game will be paused if disconnect happened. It works in team gametypes and if both teams full. 
					Disabled by default.

4.3
Serverside gametype voting setup.

Players can vote for a variable 'sets' of settings which should be specified in 'VotingGametypes' strings of UTutcomp3v02d.ini
You can use up to 10 strings of VotingGametypes.

Example: 
VotingGametypes=(GametypeClass="UTGameContent.UTVehicleCTFGame_Content",GameTypeName="Vehicle CTF",MapList=("vCTF"),ExtraOptions=)

GametypeClass="UTGameContent.UTVehicleCTFGame_Content"		-Gametype class name
GameTypeName="Vehicle CTF"					-Short name to display in a voting menu
MapList=("vCTF")						-Map prefix
ExtraOptions=""							-Place here other game options which may be used in server command line, like ?MaxPlayer= , ?Mutator= etc.
							Please note: every settings here override same settings in command line and will be 
							used while not be overriden by next voting with this settings. Maximum length is 440 characters.
4.5
UTComp server commandline variables.

To more flexible server setup, utcomp have commandline variables which duplicate ini vars. You can use it in server cmdline or
with voting 'ExtraOptions' same as UT3 cmdline vars. It allow sets different settings for different gametypes.
Now awailable eleven variables:

    ?EnableBrightSkins= 	[0/1]
    ?EnableWarmup= 		[0/1]
    ?HitSoundsMode= 		[0/1/2]
    ?WarmupTime= 		[time]
    ?EnableDuelTDmMod= 		[0/1]
    ?AllowWeaponStay= 		[0/1]
    ?EnableNoSpawnProtection= 	[0/1]
    ?EnableArmorStacking= 	[0/1]
    ?EnableFullTeamDamage= 	[0/1]
    ?PauseOnPlayerDisconnect= 	[0/1]
    ?UnlimitedTransloc= 	[0/1]



	5.CREDITS:

	CustomUTv1b - Aaron "Lotus" Everitt.
	Overtime timer - Per-Erik Mahl aka evr3ka.
	Advanced Scoreboard code - ]HeLL[-Bagotios

	UTComp3 author - 'faust' Teleshov.  #ut3.ru on QUAKENET IRC


