MonkeyMatrixMoves

MonkeyMatrixMoves v120b

Weblinks

MonkeyMatrixMoves development page
MonkeyMatrix and Apoc Matrix Moves Forums

What is MonkeyMatrixMoves?
Requirements
What can I do in MonkeyMatrixMoves?
Configuring MonkeyMatrixMoves
Installing MonkeyMatrixMoves
Multiplayer MonkeyMatrixMoves
Compatability
Changes in this Version
Server Administration
Known Bugs/Issues
Credits and History

What is MonkeyMatrixMoves?

MonkeyMatrixMoves is everywhere. It is all around us, even now in this very room. You can see it when you look out your window or when you turn on your television. You can feel it when you go to work, when you go to Church, When you pay your taxes. It is the world that has been pulled over your eyes to blind you from the truth.

MonkeyMatrixMoves is a mod for Unreal Tournament 2003 which simulates both bullet time and adds some aerobatic stunt moves to the gameplay.

MonkeyMatrixMoves started out as two seperate mods/mutators; MonkeyMatrix and APOC Matrix Moves. The two mods have joined forces to create a more involving mod experience.

This build was submitted to epic's make something unreal mod contest.

Requirements

In order to use MonkeyMatrixMoves v1.2b, you will only need UT2003.

However, we strongly recommend you use UT2003 v2225 or above. This mutator has NOT been tested on older versions, and therefore may have issues when running on any version of UT2003 before v2225.

What can I do in MonkeyMatrixMoves?

MonkeyMatrixMoves brings many new features to UT2003. Among other things, you can activate bullet-time and perform mind boggeling mid-air stunts.

Detailed below are the new moves and features, with information on how to use them.

Name	Description	How to activate it
Bullet Time	Bullet time slows down the gameplay. Everything slows down, including weapons, player movement and projectiles.	When you have adrenaline (more than the minimum required, which you can set in the mutators config menu) press you bullet time activation key. This key bind can be changed from the UT2003 controls tab in the UT2003 settings menu.
Double Jump	Similar to the UT2003 double jump, but can be performed at any time, not just when you are at the top of your first jump. Can be used to gain extra hight or to dodge projectiles in mid air.	Simply press jump when you are in the air.
Crouch Hover	Allows you to hang in mid air. While in crouch hover, you can shoot and change weapons. Is limited to 7 seconds and can only be used once per jump.	When in the air, hold crouch. You can end the hover early by letting go of crouch.
Air Dodge	Allows you to spontaneously change direction while in the air.	While in the air, double tap either forward, backward, left or right depending on the direction you wish to air dodge.
Super Jump	You jump higher than normal.	While on the ground, hold crouch then press jump.
Wall Run	Allows you to run along walls.	When next to a wall, dodge towards the wall to start the run. Hold down the same direction you dodged in to keep running, press jump to flip off the wall.

Detailed below are the MonkeyMatrixMoves Gametypes, with information on what they do.

Name	Description
MonkeyMatrixMoves Mutator	Allows MonkeyMatrixMoves to be played with standard UT2003 gametypes. Use the mutator config menu to select arena or instagib and change various game settings, including minimum adrenaline usage per bullet time activation.

Configuring MonkeyMatrixMoves

REMEMBER: Set your bullet time key bind in the UT2003 settings menu, on the controls tab.

The mutators config menu
When selecting MonkeyMatrixMoves as a mutator from the mutator selection tab on 'instant action' or 'host a multiplayer game', first click on the mutator, and a button labeled 'Configuration' will appear in the bottom left of the menu. Click on this button to enter the MonkeyMatrixMoves v1.2b config menu.

MatrixMoves only in bullettime
When turned off, players can use the new stunt-like moves at any time. When turned on, players can only perform the stunts while using their bullet time combo.

Minimum adrenaline usage
This is the minimum amount of adrenaline that must be used each time bullet time is activated. This is here to stop people from start/stop spamming with bullet time in online games.

Minimum adrenaline to start
This is the minimum amount of adrenaline that the player must have before they can start bullet time. This is also to stop people from on/off with bullet time in online games.

InstaGib, Zoom InstaGib, Arena, Remove Superweapons
These are replacements for the UT2003 mutators.

Bullet Weapons Only
This will replace all weapons and ammo with only bullet-firing weapons, e.g. minigun and assault rifle.

Maximum Hover Time
This sets the maximum amount of time a player can crouch hover for before the hover automatically ends. Setting this value to zero results in crouch hover being disabled.

Adrenaline Regen based on Players
Will automatically set the adrenaline regen rate depending on the number of players currently in the game.

Adrenaline Regen Rate
If Adrenaline Regen Based on Players is turned off, this allows you to set the regen rate manually. This is the number of seconds it takes to regenerate 2 adrenaline points.
e.g. a setting of 1 indicates every second a player will get 2 adrenaline points.

Bots Activate Bullet Time
When selected, bots will use their adrenaline to activate bullet time. Turn this off if you want to be superior to the bots.

Enable UT2003 Combos
When turned on, this allows players to use the speed, invisible, berserk and booster combos like in normal UT2003, aswell as the bullet time combo.

Installing MonkeyMatrixMoves

ut2mod version
To install MonkeyMatrixMoves from a ut2mod, just double click on the ut2mod file. This will launch an install program, just follow the on-screen instructions and point the installer to your UT2003 directory (usually c:\UT2003\).

zip version
For people with linux and below UT2003 v2199, you can install MonkeyMatrixMoves from the zip version available for download on the internet. You can find zip version download links on the files page of the MonkeyMatrixMoves development site. Simply use a zip archive extractor like winzip to extract the zip file to your UT2003 directory (usually c:\UT2003\).

Multiplayer MonkeyMatrixMoves

Does it work in multiplayer?
Yes, it does. Go forth and frag!
(you will need UT2003 v2225 or above).

How do I find a server?
In the UT2003 server browser, select the filter tab and set the 'Any mutator' to 'This mutator' and then select MonkeyMatrixMoves in the new combobox that appears. Then, select the tab which corresponds to the gametype you want to play, DM, CTF, BR etc. and then click the 'refresh list' button, and wait for the servers to start appearing.

How do I run a server?
Just set MonkeyMatrixMoves (Matrix_v120.MutMonkeyMatrixMoves) as an active mutator. See the Server Administration section of this readme for ntoes on configuring the mutator via the servers .ini file, or if you use the UT2003 menu system to start up your server, use the mutators configuration menu, as explained in the Configuring MonkeyMatrixMoves section.

Animations now work!
This version contains fixes for the 'floaty' animation effect. Animations in multiplayer should work fine now.

Compatability

Here is a table of mods/mutators etc. which have been tested with MonkeyMatrixMoves

Default UT2003 mutators

Name	Side Effects
Arena	Selectable via the MonkeyMatrixMoves configuration menu
Big Head	No known issues
Camouflage Combo	No known issues
Delayed Spawn	No known issues
Floaty Cadavers	No known issues
InstaGib	Selectable via the MonkeyMatrixMoves configuration menu
LowGrav	No known issues
No Adrenaline	Not Compatible
Pint Sized Combo	No known issues
Quad Jump	No known issues
Regeneration	No known issues
Remove Superweapons	Selectable via the MonkeyMatrixMoves configuration menu
Slow Motion Corpses	No known issues
Vampire	No known issues
Zoom InstaGib	Selectable via the MonkeyMatrixMoves configuration menu

Custom UT2003 mods and mutators

Name	Side Effects
Greed v3.1	Singularity cannon mutator will cause superweapons to not spawn, without replacing the superweapons with the singularity cannon. No other known issues.
Ninja Rope	No known issues

Changes in this Version

MatrixMoves only in Bullet Time. This only allows people to wallrun, roll etc. when in bullet time. This defaults to on, but can be turned off from the mutators configuration menu.

Button press Bullet Time activation (bound from the UT2003 control settings menu).

Slow-motion sounds when in bullet time.

Smooth time changes.

Tweakable adrenaline regen rates etc.

Enable/Disable UT2003 combos.

Enougth customizable controls to keep you busy for weeks.

Instagib, Zoom instagib, bullet weapons only, arena and remove super weapons selectable from the mutators configuration menu.

A whole bunch of other stuff, which I have probably forgotten about.

Server Administration

For those of you who are running servers, here are some details about configuring the mutator from ini files, etc.

Don't forget to add the mutator to the list of serverpackages. To do this, add this line to the [Engine.GameEngine] section of the servers .ini file:
ServerPackages=Matrix_v120

To configure the mutator, add this section to your UT2003.ini or servers ini file:

[Matrix_v120.MutMonkeyMatrixMoves]
ArenaWeaponClassName=Matrix_v120.AssaultRifle_Matrix
bArena=False
RemoveSuperWeapons=False
Instagib=False
ZoomInstaGib=False
SmoothTimeChanges=True
bBotsActivate=False
BulletWeaponsOnly=False
SpecialMovesinBT=True
MaximumHoverTime=7
MinAdrenUse=1
MinAdrenUseStart=1
AdrenalineBasedOnPlayers=True
AdrenalineRegenRate=1.000000
UseOldCombos=False

WARNING: If you want to run either arena, instagib, zoom instagib, bullet weapons only or remove superweapons:
If you set one of these values (bArena, InstaGib, ZoomInstaGib, removesuperweapons, bulletweaponsonly) to true, set all of the other values to false. If you do not, it may cause the server to crash or the game may have strange side-effects while playing.

For example, if you are running instagib:
Instagib = True
bArena = False
RemoveSuperWeapons = False
ZoomInstaGib = False
BulletWeaponsOnly = False

Maximum hover time is the longest time, in seconds, that a player can crouch hover for. When set to 0, crouch hover will be disabled.

The ArenaWeaponClassName is the class name of the weapon which will populate the game if bArena is set to true. Here is a list of MatrixWeapon classnames:
Matrix_v120.AssaultRifle_Matrix
Matrix_v120.BioRifle_Matrix
Matrix_v120.ShockRifle_Matrix
Matrix_v120.LinkGun_Matrix
Matrix_v120.Minigun_Matrix
Matrix_v120.FlakCannon_Matrix
Matrix_v120.RocketLauncher_Matrix
Matrix_v120.SniperRifle_Matrix

MinAdrenUse is the minimum amount of adrenaline a player must use each time they activate the bullet time combo. MinAdrenUseStart is the minimum amount of adrenaline that the player must have before they can start the combo. Both of these values are up to you to set, and are designed to help prevent players from spamming the combos on/off during the game, and to help stop the game being in slow motion all the time.

SpecialMovesInBT is a boolean variable which controls when people can use the stunts. When set to true, players can only use the new matrixmoves when in bullet time. If set to false, players can use the stunts whenever they want.

bBotsActivate will allow bots to use their adrenaline like a player would. This defaults to off, but can be turned on to make the bots more player-like.

SmoothTimeChanges is another boolean value which determines wheather or not to do the 'slide-in' and 'slide-out' time effects when activating and deactivating bullet time. When it is on, the game will slow down or speed up over a period of about 0.5 seconds, giving a smoother feel to the game. When turned off, the gamespeed will change, like in older versions on MonkeyMatrix, immediatly.

UseOldCombos controls the ability for players to use the UT2003 combos (speed, invis, berserk, booster).

Known Bugs/Issues

Compatability
MonkeyMatrixMoves v1.2b has not been tested on versions of UT2003 prior to v2225. We HIGHLY recommend only using this mutator on v2225 or higher, due to possible issues with earlier versions.

Bugs

Bullet trails and other trail effects may continue through walls before finally disappearing.

Gamespeed settings in game rules tabs for servers or instant action will not work. The game will always start at 100% speed regardless of these settings.

Found a bug?
Email MonkeyCircus or [Apoc]Death at the following addresses:
monkey@monkeycircus.cjb.net
death@apoc.org

Credits and History

Quick history of how MonkeyMatrixMoves was developed
MonkeyMatrixMoves started life as MonkeyMatrix v1b, a simple and quite lame mutator developed by Adam "MonkeyCircus" Bradley. This was a first ditch attempt at simulating bullet time in UT2003. Since then, MonkeyMatrix was developed into a pretty decent UT2003 mod with a new gametype and some pretty cool slow-motion fraggin' action. Then came APOC Matrix Moves, brain child of Rob "[Apoc]Death" Gutermuth. Still under development at the time, this UT2003 mutator was a perfect addition to the mods theme, allowing players to do a whole host of cool stunts by pressing different combonations of keys. So, MonkeyMatrix became MonkeyMatrixMoves, to signify the splicing of the two mods.

Who are the people involved in MonkeyMatrixMoves development?

Adam "MonkeyCircus" Bradley
MonkeyMatrix original design and coding.

Rob "[Apoc]Death" Gutermuth
APOC Matrix Moves original design and coding.

Thanks to the following people for testing, feedback and reporting bugs:
Nick "Your_Mum" Pascoe
Glenn "Genoshin" Chiu
Jason "DarkElvis" Watkins
[Apoc]War
[Apoc]Famine
[Apoc]Cataclysm
Scott Berger
NewbieServer.de
Gus-UK
Pro-Filer
Kaadu
Vertigo
Chrisivx
HawkofWar

And thanks to all you guys for playing MonkeyMatrixMoves!