
Apoc MatrixMoves v3.0.0
---------------------
by Rob "[Apoc]Death" Gutermuth

death@apoc.org
http://www.apoc.org


22 June 2008

This is the port of Apoc MatrixMoves to UT3, with yet another series of tweaks
and improvements over the last UT2004 version, v105_beta2.  If I get more
adventuresome, I may do a bit more development.  You never can tell with me. :) 

For those that don't know, this is a mutator for UT3 that adds the acrobatics
of The Matrix to your FPS mayhem...  It's a remake of the classic mutator by
Reactor4, MatrixMoves, for original UT.  They make a lot of other great stuff,
so check them out here: http://reactor4.planetunreal.gamespy.com

Questions, comments, feedback, whatever MatrixMoves related nonsense you can
think of, bring to our forums at: http://www.apoc.org/mmforums3/

This thing is definitely playable online!  It's the way the game was _meant_ to
be played!!  ;)  More servers make the MatrixMoves community that much better,
so bring em on!!  Feel free to advertise them on the MatrixMoves forums!!
Also, check out Apoc's public server, "Apoc MatrixMoves Official Server (Hosted
by Clanwarz.com!)" in the server browser !!  Apoc MatrixMoves, mildly tweaked
standard weapons, and fascist adminning by me, [Apoc]Famine, and the rest of
the Hordesmen of the Apocalypse...  What more could you want?!  ;)
 
__________________________
Installation Instructions:

Unzip this file into your "My Games/Unreal Tournament 3" directory...  All
files should be in your System subdirectory except this README, which should be
in your Help subdirectory.  Edit the UTApocMatrixMoves_v300.ini to customize
your MatrixMoves experience.  

__________________________
Summary of player features:

Mid-Air Jump: now one can "double jump" at any time while in the air, instead
of just at the apex of a previous jump.  Furthermore, the number of Mid-Air
Jumps allowed per flight is configurable.

Wall-Jump: You can also hop up a wall with a few quick jumps.  Just face a wall
and start Jumping.  The number of Wall-Jumps allowed per flight is
configurable.

Super Jump: while on the ground, hold crouch then jump for a super high jump.

Mid-Air Hover: hold crouch while in air to hover in mid-air...  can aim, fire,
and change weapons while hovering...  There is a configurable time limit for a
single hover that defaults to 7 seconds, or just release the crouch button to
resume normal flight.  One hover per flight is allowed.

Rolls/Flips: By default, Dodges are now rolls or flips, making a snazzy
(and potentially stomach churning) viewport flipping effect. 

Dodge/Roll in Air: No longer limited to Dodging while on the ground, one can
now dodge/roll in mid-air if desired...  As in classic MatrixMoves, this
feature zeros out negative Z velocity, so it and the Mid-Air Jump can be used
prudently to save yourself from taking damage after big falls.  The number of
these that you can do per flight is configurable.

Wall-Dodge: Now you can Wall-dodge multiple times (the number is configurable),
a great trick for zooming around in confined spaces.

Wallrun: Dodge into a wall when close to it and you'll wallrun on it.  The
Wallrun is very free-form now; no longer are you locked into up-down and
left-right motion, or just flat surfaces.  This thing works almost anywhere,
and you can change directions and facing as if it were normal motion (sortof).
Wallrun ends if you stop moving (it is a wallRUN after all), if you go vertical
(either hit a "ceiling" or a "floor"), or if you jump, which can result in a
sweet flip off the wall!  There is also a configurable time limit for
Wallrunning of 7 seconds by default.  You can Wallrun as many times as you want
up to that time limit before touching regular flat ground or terrain.

Client-side Roll Configs: I implemented crude client-side configuration of the
rolls, which can be disabled server-side.

Type "mutate mm" at the console to list the available options and their current
setting.

Type "mutate <option>" to toggle one of the options on or off... 

The options are:

FBRolls: 
Toggle forward/backward flips on or off.

LRRolls: 
Toggle left/right rolls on or off.

RollInAirOnly: 
Toggle on to only roll while in mid-air.  Dodges from the ground are
"normal", non-flipping dodges if this is true.

NoWallDodgeRoll: 
Toggle on to not roll when doing a Wall-Dodge.

These client-side changes are only remembered until the end of session on a
given server or until the end of a given map in single player offline play.
Sorry, for now they are reset once you leave play.  :( 

_____________
Server Admins/Single Player Configuration:

Server-side/single player configs are all in the UTApocMatrixMoves_v300.ini:

	[ApocMatrixMoves_v300.MutApocMatrixMoves]
	MaxHoverTime=7.00000
	MaxWallrunTime=7.00000
	MaxWallDodges=3
	MaxWallJumps=5
	MaxAirDodges=1
	MaxMultiJumps=1
	bRollEnabled=True
	bWallrunEnabled=True
	bClientCanConfigRolls=True
	bFBRolls=True
	bLRRolls=True
	bRollInAirOnly=True
	bNoWallDodgeRoll=True
	bWallrunJumpFlip=True

MaxHoverTime: in seconds...  set to zero to disable hover

MaxWallrunTime: in seconds...  set to zero to have unlimited wallrun

MaxWallDodges: Maximum number of times you can Dodge away from a wall in
mid-air before landing.

MaxWallJumps: Maximum number of times you can jump while facing a wall before
landing.

MaxAirDodges: Maximum number of times you can Dodge in mid-air (in addition to
Wall-Dodges) before landing.

MaxMultiJumps: Maximum number of times you can jump in mid-air (in addition to
Wall-Jumps) before landing.

bRollsEnabled: True enables, false disables all rolls.

bWallrunEnabled: True enables, false disables all wallruns.

bClientCanConfigRolls: Toggle on to enable client-side roll configs; false
locks them in to the default settings, which can all be defined here as well:

bFBRolls: Toggle forward/backward flips on or off

bLRRolls: Toggle left/right rolls on or off

bRollInAirOnly: Toggle on to only roll while in the air; Dodges from the ground
are "normal", non-flipping dodges if this is true

bNoWallDodgeRoll: Toggle on to not roll when doing a Wall-Dodge.

bWallrunJumpFlip: Toggle on to roll when Jumping out of a Wallrun.


The mutator name for calling this from UCC is (again, for servers)

	ApocMatrixMoves_v300.MutApocMatrixMoves

Any questions, bring them to me either through the forums (
http://www.apoc.org/mmforums3/ ) or by email ( death@apoc.org )...  

Enjoy!!!

-[Apoc]Death
