====================================================================================
ReadMe for MK3rdPersonMutator
====================================================================================
Author:                           Jeremy J Collins
Platform:                         Unreal Tournament 3 Retail
Website:      
Original release date:            November 24 2007
Current version release date:     June 10 2008
Version:                          2.0

====================================================================================
Installation
====================================================================================
Unzip the package to your ..My Games\Unreal Tournament 3\UTGame directory.

The .u file(s) will be stored in your 
..My Games\Unreal Tournament 3\UTGame\Published\CookedPC\ directory.

The .ini file(s) will be stored in your 
..\My Games\Unreal Tournament 3\UTGame\Config\ directory.

All documentation will be stored in your
..\My Games\Unreal Tournament 3\UTGame\Documentation\MK3rdPersonMutator\ directory.

The source code is included and will be stored in your
..\My Games\Unreal Tournament 3\UTGame\Src\MK3rdPersonMutator\ directory.

====================================================================================
Manual
====================================================================================
<<OVERVIEW>>
This mutator allows players to play in first or third-person perspective when not 
in a vehicle.  The third-person camera's follow distance (or zoom) can be changed
by the player, but must fall within the limits set by the server.

<<BINDS>>
This version does not include the necessary key binds to make the mutator work. 
To setup the necessary key binds please do the following at the console:

setbind <KEY> togglecamera
setbind <KEY> increasecamerascale
setbind <KEY> decreasecamerascale

I typically use:
setbind p togglecamera
setbind i increasecamerascale
setbind o decreasecamerascale

<<UTMK3rdPersonMutator.ini File Settings>>
** Only relevant settings are shown below **
** Comments are shown after the // and should not be in the actual ini file **

[MK3rdPersonMutator.MK3rdPersonMutator] // These values are used server-side
Validate=VALID				// If this value is changed the ini file recreates itself.
MinimumCameraScale=1.000000		// Minimum camera scale allowed (or how close the camera is to the player) 
MaximumCameraScale=40.000000		// Maximum camera scale allowed (or how fare the camera is from the player)

[MK3rdPersonMutator.MKPawn]		// These values are used client-side
CameraScaleAdjustSensitivity=2.000000	// How far in or out the camera moves with each press of appropriate zoom button
bStartIn3rdPerson=True			// Start in third-person or first-person
MyCameraScale=10.000000			// Currently saved camera scale

<<CONTACT INFO>>
Please send bug reports to: munkyware AT gmail DOT com

====================================================================================
Changes
====================================================================================
1.0: Initial release
1.1: Added the ability to change the thirdperson camera zoom in the
	UTMK3rPersonMutator.ini.  This is a serverwide setting and 
	currently not configurable on a user by user basis.
   : Removed some DEBUG log entries.
1.2: Fixed bug where the camera zoom setting (CfgCameraScale) in the ini file
	was not being sent to clients unless they were also the server.
   : Fixed a bug when feigning death.  Returning from the feign death state should
	no longer revert and lock the view in first person.
1.5: The server now sets the default camera zoom setting for players who are using
	the mutator for the first time.  Once a player joins and adjusts the zoom
	setting that player's setting is saved in their local ini file in the 
	MyCameraScale value.
   : The player can now toggle between first and third-person views when not in
	a vehicle.
   : The server now sets the Minimum and Maximum camera zoom settings.  The player
	can manipulate the camera zoom between these values.
   : The player can set the camera zoom speed sensitity by adjusting the
	CameraScaleAdjustSensitivity value in their local ini file.
   : Changed ini file variable names to be consistent with Epic code standards.
2.0: Incorporated an aiming fix when in thirdperson.  Projectiles now hit where the
        crosshair is pointing.  This function was incorporated from the ActionCam 
        mutator and modified to mimic the thirdperson aiming example provided by the
	function GetWeaponAim in UTVehicle.  The source code is marked as such.
   : Fixed a bug that rendered the firstperson arm meshes when equipping dual
        enforcers for the first time.

====================================================================================
Roadmap
====================================================================================
2.1: Mutator keybinds incorporated 

====================================================================================
MK3rdPersonMutator Copyright (C) 2007 Jeremy J Collins.

MK3rdPerson is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see http://www.gnu.org/licenses/.

====================================================================================