by Tuomo 'Tuco' Korva & Heikki Korva
http://www.planetunreal.com/reactor4
reactor4@planetunreal.com
Release NotesRemember the amazing acrobatics in the movie Matrix ? Now you can do the same moves in Unreal Tournament with the MatrixMoves mutator. This beta 4 version has 7 moves and they look really cool in both 3rd and 1st person views. But of course you have to see it for yourself ! For the ultimate Matrix experience, combine this mutator with JadtheGerbil's excellent Lazy Matrix.
Installation
UMOD: Uncompress the zip file and double-click the file MatrixMovesBeta4.umod
Non-UMOD: Uncompress the zip file to your UnrealTournament\System directoryUsing MatrixMoves in the Game
Off-Line Play:
You have two ways to use MatrixMoves in offline single player game:
1) Choose MatrixMoves B4 DM as the game-type.
2) Choose MatrixMoves Beta 4 from the mutator list.On-Line Play:
Server:
You have two ways to setup MatrixMoves on your server:
1) Use MatrixMoves as normal mutator
2) Choose MatrixMoves B4 DeathMatch as gametype from the pulldown menu. With this option other people wanting to play MatrixMoves Beta 4 find your server much easily by using the MatrixMoves B4 DM server tab in the serverlist. Note that MatrixMoves mutator will be used always with this gametype even if you don't select it to be used.If you have installed the Non-UMOD version of the mutator, you must add the following lines to the correct files by hand (additions in red color). The UMOD installer does this automatically.
File Additions UnrealTournament.ini Additions to [Engine.GameEngine] section:
ServerPackages=MatrixMovesBeta4
ServerPackages=MMb4_Pluginpack1
Addition to the end of file:
[UBrowserMMb4DM]
ListFactories[0]=UBrowser.UBrowserSubsetFact,
SupersetTag=UBrowserAll,GameType=MMb4DeathMatchPlus,
bCompatibleServersOnly=TrueUBrowser.int Additions to [ServerListTitles] section:
UBrowserMMb4DM=MatrixMoves B4 DMClient:
You have two ways to finding Internet games using the MatrixMutator Beta 4:
1. Go to Find Internet games and click on MatrixMoves B4 DM tab on the serverbrowser.
- Note that the tab will be added to the browser the first time you activate the MatrixMoves configuration window.
2. Browse all populated servers and try to find a game using the MatrixMutator Beta 4The Moves
- The moves work only with supported player classes. To find out if your current playerclass supports the moves during the game, hit TAB key to bring up the prompt, type checkmm and hit enter. If text "MatrixMoves Beta 4 Detected" is shown, your current playerclass supports the moves. See the supported classes at the end of this document for details.
- To be able to use all the moves, enable dodge from options->preferences->game in the UT menus.
Move Description Wallrun & Backflip 1. Make sure that you are near a wall facing it.
2. Do a dodge forward and keep forward button pressed down to start running up the wall. You can run the wall:
- Vertically pressing and keeping down the forward/backward buttons
- Horizontally pressing and keeping down the strafe left/strafe right buttons
- Note that you can aim with your mouse during the wallrun sequence
- If you aren't pressing any of the up/down/strafe left/strafe right keys, the wallrun sequence ends. It also ends if you try run to the opposite direction you are currently going.
4. Press jump button while running up the wall to do a backflip.Frontflip & Backflip 1. Dodge to the front or back to do a flip
- Note that you can do dodgemoves in the air.Double Jump 1. Jump normally.
2. While still in air press jump button again to get higher.
- You can do only one Matrix Jump during one normal jump.Freeze 1. Press and hold the crouch button while in mid-air to freeze
2. During the freeze you can turn and use weapons.
3. After letting go of the crouch button or after maximum freeze time has passed you will continue to move to the direction you were initially going.
4. Freeze can be used again after landing to the ground.Side Cartwheels 1. Dodge to the left or right while standing to do a side cartwheel
- Note that you can do dodgemoves in the air.Side Spin 1. Dodge to the left or right while crouching on the ground High Jump 1. Press jump button while crouching on the ground
Configuration OptionsYou can configure some key attributes of MatrixMoves from the config window accessible from menus (Mod->MatrixMoves) in the UnrealTournament's main window. The changes take affect when a new level is loaded or current level restarted.
Option Description Maximum Wallrun time Maximum amount of time in seconds player can run vertically on the wall. Set this value to 0 for infinite amount of time. Maximum Freeze time Maximum amount of time in seconds player can freeze himself in the air. Set this value to 0 for infinite amount of time. Wallrun speed Wallrun speed, 0.1 being the slowest value and 2.0 the fastest one. 1.0 is the default value.
Supported Playerclasses
To find out if your current playerclass supports the moves during the game, hit TAB key to bring up the prompt, type checkmm and hit enter. If text "MatrixMoves Beta 4 Detected" is shown, your current playerclass supports the moves.
Original playerclasses:
By default, Beta 4 version supports all original UnrealTournament player classes.
Male/Female Soldier, Male/Female Commando, Commander, BossAdditional player classes:
You can configure the support for additional player classes from the "Additional playerclass window" accessible from "Plugins..." button on the "MatrixMoves configuration window". To be able to use the pluginclass simply click on corresponding checkbox. If you don't have it installed, an error message appears. Here are the additional supported player classes:
- All UT Bonuspack player classes
- Abbey, Alien Queen, Arab, AWolf, BobaFett, Dire, Drake, Gordon, Guardian, HellSpawn, Hunter, Lady Death, Lin Fang, Lobo, Lord Maul, Marine, Mask, Messiah, Obi-wan, Prowl, Q2Male, Ratamahatta, Rhino, Riot, Rumiko, SideSwipe, SolidSnake, Super Male, Unreal1Models, TekkBlade, Trinity, Troop, Valkyries and Yoshi.As an example, let's add support for Trinity player class:
"I have downloaded the Trinity player class from the Internet (www.utskins.com, www.fileplanet.com and www.fileleech.com have them) and installed it to my UT. Then I start UT, go to the main menu and to the MatrixMoves configuration window (mod menu).Then I click the Plugins... button on the window which opens the "Additional playerclass window". I search "Trinity" from the list of Supportedclasses and check it's checkbox. After this I simply close the window, select Trinity as my new player model, set up a new practise session and frag some bots using MatrixMoves."MatrixMoves uses a plugin type approach for supporting additional player classes. This means that you don't need any additional packages for playing MatrixMoves and it's easy to make new pluginpackages for player models which don't have MM support yet. To add support for new player classes by making pluginpackages see MatrixMoves_PluginB4 document. Note that if you want to use pluginpackages in network play, server must have them in ServerPackages list.
Known Issues
- The moves only work with the supported playerclasses.
- Bots don't use any of the new moves.
- The demo playback doesn't show the moves right.
- When playing MatrixMoves and going to the player setup, the player model may not be the right one.
- We recommend that you use the latest version of UT (v436) with this mutator.Version History
Version Changes Beta 4 - Playerclass code is completely rewritten to improve the network play
- Changed the start sequence for Wallrun
- Horizontal wallrun added !
- Added a console command for easy supported class detection ("checkmm")
- New window added for handling plugin playerclasses
- Fixed skin problem with Boss player class
- Removed the "Time between Jumps" optionThanks to
- FangsFirst for the help with playerclass pluginpackage
- UsAaR33 for the new pluginpackage architecture ideaAuthors
Tuomo 'Tuco' Korva
Heikki KorvaDecember 22nd, 2000
Copyright Reactor 4 - 2000. All Rights Reserved.
Playerclass plugin documentation for
MatrixMoves Beta 4
by Tuomo 'Tuco' Korva
http://www.planetunreal.com/reactor4
reactor4@planetunreal.com
Release NotesThis document describes the procedure to make pluginpackages for supporting new player classes in MatrixMoves Beta 4. Making the plugin package takes about 30 minutes and requires a bit programming experience.
Supported classes
By default beta 4 version supports the following player classes:
- All original UnrealTournament player classes
- All UT Bonuspack player classes
- Abbey, Alien Queen, Arab, AWolf, BobaFett, Dire, Drake, Gordon, Guardian, HellSpawn, Hunter, Lady Death, Lin Fang, Lobo, Lord Maul, Marine, Mask, Messiah, Obi-wan, Prowl, Q2Male, Ratamahatta, Rhino, Riot, Rumiko, SideSwipe, SolidSnake, Super Male, Unreal1Models, TekkBlade, Trinity, Troop, Valkyries and Yoshi.MatrixMoves B4 uses a plugin type approach for supporting additional player classes. This means that you don't need any additional packages for playing MatrixMoves and it's easy to make new pluginpackages for player models which don't have MM support yet.
How to make a new playerclass plugin
There are two ways to make plugins:
I If the playerclass you want to support doesn't have any mod specific code (like Rumiko or Obiwan), you should add your subclass below MM_BaseMale or MM_BaseFemale. However, if the playerclass you want to support has mod-specific code (like Infiltration or U4e), you should add your subclass below the class you want to support. Look at the examples below to see how to make new pluginclasses.Example 1. Making a plugin for Trinity player class
1. Make sure you have MatrixMoves Beta 4 and the unsupported player class installed to UT
OK, MatrixMoves Beta 4and Trinity are both installed.2. Open Unrealtournament\System\Unreal.ini file and add MatrixMovesBeta4, MMB4_PluginPack1 and the unsupported packages to the end of editpackages list
Open file in notepad. Search for editpackages and add the lines to the end of the list.
EditPackages=MatrixMovesBeta4
EditPackages=MMB4_PluginPack1
EditPackages=Trinity3. Fire up UnrealEd and find the unsupported player class from the class hierarchy. Also click on the export all scripts.
Trinity seems to located in Pawn- PlayerPawn- TournamentPlayer- TournamentFemale-Trinity. I also export all the scripts.
4. Add a subclass to either MM_BaseMale or MM_BaseFemale depending on where the unsupported playe class was located.
Trinity is located under TournamentFemale so I'll use MM_BaseFemale.The class has some new code but it doesn't contain any mod-specific code. Right click on the MM_BaseFemale in the class browser, choose create new class, put MMB3_Trinityplugin as package name and MMTrinity as new class name.5. Open the class you just created. Also open some other pluginclass that has been already created.
OK, MMTrinity and MMaqueen are opened in the editor.6. Copy the code from an already ready pluginclass to the new class you created. Then open the UC file of unsupported class you exported earlier and copy/paste all the code excluding the model import code to your new class. You also need the default properties section.
I copy the code from aqueen class to Trinity class. Then I open the exported file in some text editor from F:\UT\Trinity\Classes\Trinity.uc and copy all the text from there to the trinity class open in UnrealEd2. After the copy I remove all the import commands from the class.7. Modify the code in you new class in function PostBeginPlay so that the variables being initialized are the ones you just copied from the UC file.
Trinity has some own code for handling animations so I put it to the start of the class. To the end of the class I put the function PostBeginPlay and modify it so that it has the values of Trinity instead of Alien Queen. For example, I change the mesh to be loaded from aqueen.aqueen to Trinity.Trinity. The variables that Trinity doesn't have can be destroyed and the ones that Trinity has but the Alien Queen doesn't have I add as new ones.8. Then I just hit compile and save the package.
Just press the compile button, then select the MMB4_TrinityPlugin package from list and press save selected packages.9. Open Unrealtournament\System\MatrixMoves.ini file in some text editor. Add the original player class name to the first empty line in SupportedClasses. Then add the name of the class you created to the first empty line in PluginClasses.
Open file in notepad. Add the lines to the first empty line which in this case is after the cow class. The class name consists of package name and class name so for the original trinity class it'strinity.trinityi and for the plugin class it's MMB4_TrinityPlugin.MMtrinity.
SupportedClasses[0]=multimesh.tcow
SupportedClasses[1]=trinity.trinity
PluginClasses[0]=MMB4_PluginPack1.MMtcow
PluginClasses[1]=MMB4_TrinityPlugin.MMtrinity10. You're done. Test if the plugin works in the game.
Example 2. Making a plugin for Infiltration player class
1. Make sure you have MatrixMoves and the unsupported player class installed to UT
OK, MatrixMoves Beta 4and Infiltration are both installed.2. Open Unrealtournament\System\Unreal.ini file and add both packages to the end of editpackages list
Open file in notepad. Search for editpackages and add the lines to the end of the list.
EditPackages=MatrixMovesBeta4
EditPackages=InfiltrationUT (Not sure if the Infiltration package name is really that !)3. Fire up UnrealEd and find the unsupported player class from the class hierarchy
Infiltration player class seems to located in Pawn and the class name is INFUT_TMale1
4. Add a subclass for the unsupported player class and put it to a new package
Right click on the original class in the class browser, choose create new class, put MMB4_Infiltrationplugin as package name and MMInfUT_TMale1 as new class name.5. Open MM_BaseMale class under Male1 and copy all the code from it to new player class you created
Copy/paste the code from MM_BaseMale to the MMInfUT_TMale1 class.6. Compile code and save the new package.
Just press the compile button, then select the MMB4_Infitrationplugin package from list and press save selected packages.7. Open Unrealtournament\System\MatrixMoves.ini file in some text editor. Add the original player class name to the first empty line in SupportedClasses. Then add the name of the class you created to the first empty line in PluginClasses.
Open file in notepad. Add the lines to the first empty line which in this case is after the cow class. The class name consists of package name and class name so for the original nali class it's multimesh.tnali and for the plugin class it's MM_BonuspackPlugin.MMtnali.
SupportedClasses[0]=multimesh.tcow
SupportedClasses[1]=InfiltrationUT.INFUT_TMale1
PluginClasses[0]=MM_BonusPackPlugin.MMtcow
PluginClasses[1]=MMB4_InfiltrationPlugin.MMInfUT_TMale1
(Not sure if the Infiltration package name is really that !)8. You're done. Test if the plugin works in the game.
December 22nd, 2000
Copyright Reactor 4 - 2000. All Rights Reserved.
BMfr 6 ( W R 0n . . Ľ ƿ w {[ }} 0 zR |K t] ) A : ~B ) {J o[ ~; 2 1 " qS ; zk |C {; sQ qR * k[ rK ) |< " uB ) uh |1 ! ~2 nR $ |1 nJ " qB hU {) }) lJ hQ nB ]] s8 q; jJ |" {) nll t2 {! lA [Y q3 aS t* z n: lZ t) n4 cL cG u fB t! p( l0 s US m* s dbb [G a8 cQ ^B `8 l YE j e) OL \6 j v[Q [8 c" [2 PH _( t[J NB II mXJ \) ^ b R: a uVA \! fTH IF URR W) S3 Q3 S2 Y" Z O4 T$ BB G: Z WMI J5 Q# K2 P" H5 K) S V R I) =9 R J# << gH3 B/ |I" B0 K FCC C( A* L }I F G 90 66 J {A! sB! u71 |A z;$ tA U<. {E j8' sB h9! r9 k; s: c: g0, q; 633 t++ b2! j2 k9 k< Q4" [2 e8 e2 [1 J-# S1 [*% a2 Z1 T1 S&& /** J* R) Y1 B) W!! R. Q) B) J) J B I) :" C! @ :! / @" : 3 ) 1 : ) 1 2 0 " ) * ! Z Z ҥ㑑xփ{{{{{{{xӠrrrrrrr{{rxxӃrr{{{ֵr{{{{{{rߵ{{{rr{{{{{{rֵփxxӃrr{{{rxxxxx⠠֠{xxxxx{ߵ{x e xW{ r{ r r {փ r * r r x r 7* {{ߠ e M *xӃrr xr r{W xW r Ӄ r ӠxW x r r x{W ZMe e Wx* rr h rx r *h r r r 7r rrx 7 ee ҥ {́ rxhhh r*r rr * * r ̠r xx 77 hrxh e M { W hr *h r h r̠ r ́ h̠ rhxx hW W eeeM7ʹhԠh̠Ǡ*hWhʵhʠW*x *hWʽWhh*Ӡ*Ё ʽ¹ʽʽ ʹɹɽ·ǹɽʽʽʽʽ ʹɹ·ù··ʽʽʽʽʽ Ͻʽʽ·ɹɹ··ɹʽϽʽʽʽZʽɽ·ʽȻʽʽ ;ó ;ͱvvvvvllllZZZZZZZZ[[DDDDD;;EE--........... 0000000EEEE;;;DDDDJJJJJJZZZZZZZZZZZZZZZZAAAAASSSAAAAAAAAA[JJJJJJJJJD;;;---->>>>--.......1111.>>>>DDDD;;;D[[JJJJJJ]]]]iiiiiiiiijjjjpuuuuu ;;vvvllliZZZZZZZZ[JDDDDDD;;D-----........ 0000000EEEEDDD;;;DDDD[JJJZZZZZZZZZZZZZZZZZZAAAAAAAAAAAAAA[JJJJJJJJJJJDDDDDDDDDDDD--->>>>>111111.111->>>>DDDDDDJJJJJJJJJJ]]]iiiiiiiijjjjjppppppu ѵ;;sssssssipppppiipliiiillllllllllllllsssllssssuuuuuuuuuuuuuupppppppppiipppppppppssssssssssssssss± нδǾ ļĴĻĴ IJĴZĴĴ ļ ȿļó mkk^^kkkkkkqq^Uk~k^^^^kk^^k^^^^XCC__XXX___XXXXNNNNNNjjIIIIVYYRRNN_X==X}tLC^CCXXXXXXXX____c|nN)N333VVIVVVIIIIYw`NN===XXXXXXCCCCCk~mLOOOOUUU^^^UUUCC^LCXXXXXOOOLL^^C2mtBO\^^^^LL======T_mmk^^^^XXXXCCCOOOOO~ȼoyooϜbbQyobooz 944'''4444??99/?~q?'499999///??////BB6%%8888%%%%%%%,$YY,,,,,$$$&&&:6///kk66!!6666/&&&:Xnc$ $$$$ =`R%%%%%%%%%&&////^m^2!!!!!9999999 ?qq2////////6666 ^k///?66666///6///B^^C6666////4444''''qȼyGQyoGQʬbQoby۬QGbbQzzQboGz 944444444?OO444K~~\KKOKKKK///KK//B6TTB%%88888888 ,,,,gY $$ :::6666BB6kkC&&&&&CCC6%88 :Rn`$ HHH$$ NnR &&666666///^q^???!!!????6666666kmC/////6///6KK/^m66666666666B///B__B//226644444444 9~ϻGbɏGybbɳGooGGoͭoGb 94?944?99\aO///OkX^\OOOOOB66BBB&B__N%%$HNNHHH$$$$$$gj $$$:TTB6666CCCtt=&:::::XT88NN$$$Rw` 5IHHH Rw_$=& &&BBBBBB&d~d???!!!!??O?66?<66m}C6666666C6//6BC_t/222222%&CCCB&&&=kkTBBOOKK??66''99 ?ɏGoQoyQQboooQzQbzGobooQGG 99K449KKKOOK6BBX}XXXXBXKKKK6/BB&%8__N,,,HHHHHH555@@ Vj$$$$8BTBB6666::L}: &&8888NN$$HH V|` """" H55H R|c)=:&&&&&&6BBB66d~d2222 2?OO22CCm}B&BB&&2CC2///22ct/666BB&&&CXCB&&&XmcXBTTT????2!!!?9'?ɏGoQoyGGbzbGQQzozGbzGoGbZ?9O99OOKKKKKKTBX}T:TTTTTB6666BB8%8__N,,,HHH555555F@ Vj$$::%8CCCCCC666C= ::$$$HHH$$$$ Puj"""""""@@@@ Y`$))):&&&&&BB6666k~d<<<>>>>>>>1]j $XX:::::CCCXC8TNHRI5Fgg@D]si.""""55@@@@@""`` 33:::&&22CC66qq?9?