Actionmapper Guide - Revision history

Bird Thing: /* Frequently Asked Questions */

2023-08-26T19:19:24Z

‎Frequently Asked Questions

RickHunter: /* Things to know before you begin */

2022-04-19T02:28:33Z

‎Things to know before you begin

DeimosEvotec: added Manual Edits Section

2019-02-18T13:01:16Z

added Manual Edits Section

Unbroken at 03:28, 21 August 2017

2017-08-21T03:28:13Z

Unbroken at 17:10, 15 August 2017

2017-08-15T17:10:15Z

Unbroken at 16:35, 15 August 2017

2017-08-15T16:35:14Z

Unbroken at 16:34, 15 August 2017

2017-08-15T16:34:57Z

Unbroken at 16:30, 15 August 2017

2017-08-15T16:30:33Z

Unbroken: port to new name

2017-08-03T16:47:17Z

port to new name

New page

The [[Actionmapper]] tool is an interim solution to being able to modify the keyboard, mouse, and joystick bindings for all controls needed for Mechwarrior Living Legends (MWLL).

== Things to know before you begin ==

* The MWLL Launcher requires the [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en .NET framework] to run.
* The [[Actionmapper]] requires a [http://www.java.com Java installation] to run.
* '''NEVER''' attempt to modify controls using the Crysis Wars in-game settings menu.
* '''NEVER''' attempt to modify controls using the Actionmapper while Crysis Wars is running.
* If you have not yet created a new Profile within Crysis Wars, you will need to do so before using the Actionmapper. It has been designed not to load the default Crysis Wars profile (a.k.a Nomad or Mechwarrior).

[[File:Mwll-launcher-config-actionmaps.png|350px|right|thumb|'''Config Actionmaps''' button highlighted on Launcher to the left]]
== Launching the Actionmapper ==

There are two methods for launching the Actionmapper:

* Open the MWLL Launcher desktop shortcut provided after the installation of the mod. From there click on the '''Config Actionmaps''' button on the left side of the window.

* Or, open '''Actionmapper.exe''' (not Actionmapper.jar) from the '''mods\MWLL\Actionmapper\dist''' folder located in your Crysis Wars installation location.

== How does it work? ==

The Actionmapper reads and writes to the [[actionmaps]].xml file which is used by Crysis Wars to store action to key bindings. It also integrates with the [[joystick.cfg]] file which is used to modify joystick axis settings. To support multiple profiles and actionmaps settings per profile, and since only one file can be named ''actionmaps.xml'' at a time, the Actionmapper only sets the currently '''Active''' one to be named ''actionmaps.xml'', while all other actionmaps configuration are stored with their name in the file.

 
[[File:Mwll-actionmapper-new.png|350px|right|thumb|'''New Actionmaps''' button at the top left]]
== The first sortie ==

The first time you open the Actionmapper it will name your default actionmaps file as "original". From here it is recommended that you start a new actionmaps by pressing the '''New Actionmaps''' button found at the top left of the window, after which you will be prompted to give it a name. Try naming it something short but descriptive, like "joystick" or "mouse+keyboard" so they can be easily identified if you wish to try out other configurations later.

 
 
 
[[File:Mwll-actionmapper-conflict.png|350px|right|thumb|Conflicts are shown when the action is selected]]

== Conflicts ==

One of the first things you may notice, even with a new or default actionmaps, is the presence of conflicts indicated by red colored text and an icon with a red circle and an exclamation mark. Some of these conflicts may be ok or may not be applicable, for instance if you do not plan to use a gamepad. To find out which action is being conflicted with, select the action by left clicking on it. You may clear a conflict either by setting to '''No binding''' or to another key/button that is not in use already.

 
 
 
 
[[File:Mwll-actionmapper-modified.png|350px|right|thumb|Unsaved modifications are shown]]
== Modifications ==

Each action may have up to two bindings associated with it. Some actions are analog only, meaning only a mouse or joystick axis may be assigned and must be manually selected. Most actions are digital only, meaning only a key or button may be assigned. After making a selection, any action that has been modified will be indicated by blue colored text and an icon with a blue square and an uppercase M.

 
 
[[File:Mwll-actionmapper-detect.png|350px|right|thumb|Detect Key/Button dialog while waiting input]]
=== Key/Button detection ===

Most digital keys/buttons can be detected automatically by clicking on '''Detect Key/Button''' and then pressing the desired key/button when the dialog appears. If the key or button is not detected and the device is properly plugged in to your computer, you may need to resort to manually selecting the key/button since the java detection libraries are not able to pick up on 100% of all possible input.

 
 
[[File:Mwll-actionmapper-joysettings.png|350px|right|thumb|'''Joystick Settings''' for modifying joystick sensitivity and deadzones]]
=== Joystick axis settings ===

If using a joystick, the '''Joystick Settings''' tab allows you to modify the sensitivity and deadzone levels for any axis used in your actionmaps configuration.

 
 
=== Saving ===

When all desired changes have been made, be sure to save your modifications. The Save function is available from the '''File''' menu. After saving all actions marked as modified will be unmarked.

 
 
 
[[File:Mwll-actionmapper-setactive.png|350px|right|thumb|Link to '''Set active''' at top middle of window]]

== Setting an active Actionmaps ==

When managing more than one actionmaps in a profile it is necessary for one of them to be active, indicating that it will be loaded the next time MWLL is run. Use the "Set active" link at the top middle of the window for making the currently selected actionmap active.

 
 
 
[[File:Mwll-actionmapper-rightclick.png|350px|right|thumb|Right click on selected actionmaps for more options]]
== Miscellaneous functions ==

Right clicking on the currently selected actionmaps from the list on the left side of the window provides a few extra functions, such as '''Duplicate''', '''Rename''', and '''Delete'''.

 
 
 
== Tips for new Mechwarriors ==

* The default key for entering/ejecting from a vehicle is '''F'''. If using a mouse and keyboard to play MWLL using the standard default '''WASD''' movement configuration, you may want to rebind the action "Use/Get In/Eject" to another key located further away from commonly used keys to ensure you don't accidentally eject in the middle of combat. How embarrassing it is!

* Setting up a joystick properly requires a bit of experimentation. If you find that the axes are too sensitive or not sensitive enough just head over to the '''Joystick Settings''' tab and fine tune to your liking. Alternatively you may use the "raw" setting on individual axis selections on each action that will directly map to that joystick's axis response.

 
 
 

== Frequently Asked Questions ==

'''Q: Why isn't my joystick or keyboard button press being detected when I use the Detect function?''' 
A: Assuming its plugged in and recognized by Windows, its very likely the detection library doesn't recognise it. However, the button may still work in game, you will just need to manually select it using the appropriate pull-down menu for the action.

 
 
'''Q: Why can't I assign Control/Alt/Shift plus a keystroke for an action, such as Control + O?''' 
A: Crysis Wars does not have keystroke modifier support built-in, so MWLL cannot support it yet.

 
 
'''Q: Why does the Xbox360 gamepad axis appear inverted in game?''' 
A: The current workaround is to instead set those actions to the corresponding joystick axis instead of gamepad axis, which then will allow you to set inverse on it. The left stick is Joystick X and Y axis, while the right stick is Joystick Rotation X and Rotation Y axis.

{{Navbox Guides}}

[[Category:Guides]]

@@ Line 73: / Line 73: @@
 '''Q: Why does the Xbox360 gamepad axis appear inverted in game?'''<br />
 A: The current workaround is to instead set those actions to the corresponding joystick axis instead of gamepad axis, which then will allow you to set inverse on it.  The left stick is Joystick X and Y axis, while the right stick is Joystick Rotation X and Rotation Y axis.
 == Manual Edits ==

@@ Line 5: / Line 5: @@
 *  The MWLL Launcher requires the [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en .NET framework] to run.
-* The [[Actionmapper]] requires [http://www.java.com Java] to run, which is installed when you install [[MWLL]].
+* The [[Actionmapper]] requires [https://java.com/en/download/manual.jsp Java (32 bit)] (Not 64 bit!) to run, which is installed when you install [[MWLL]].
 * '''NEVER''' attempt to modify controls using the Crysis Wars in-game settings menu.
 * '''NEVER''' attempt to modify controls using the Actionmapper while Crysis Wars is running.
@@ Line 12: / Line 12: @@
 [[File:actionmapper 2.png|350px|right|thumb|Actionmapper in 0.8.6]]
 == Launching the Actionmapper ==

← Older revision		Revision as of 16:35, 15 August 2017
Line 42:		Line 42:
	Each action may have up to two bindings associated with it. Some actions are analog only, meaning only a mouse or joystick axis may be assigned and must be manually selected. Most actions are digital only, meaning only a key or button may be assigned. After making a selection, any action that has been modified will be indicated by blue colored text and an icon with a blue square and an uppercase M.		Each action may have up to two bindings associated with it. Some actions are analog only, meaning only a mouse or joystick axis may be assigned and must be manually selected. Most actions are digital only, meaning only a key or button may be assigned. After making a selection, any action that has been modified will be indicated by blue colored text and an icon with a blue square and an uppercase M.

−	~~[[File:Mwll-actionmapper-detect.png\|350px\|right\|thumb\|Detect Key/Button dialog while waiting input]]~~
	=== Key/Button detection ===		=== Key/Button detection ===

@@ Line 72: / Line 72: @@
 '''Q: Why does the Xbox360 gamepad axis appear inverted in game?'''<br />
 A: The current workaround is to instead set those actions to the corresponding joystick axis instead of gamepad axis, which then will allow you to set inverse on it.  The left stick is Joystick X and Y axis, while the right stick is Joystick Rotation X and Rotation Y axis.
 {{Navbox Guides}}
 [[Category:Guides]]

@@ Line 23: / Line 23: @@
 == How does it work? ==
-The Actionmapper reads and writes to the [[actionmaps]].xml file which is used by Crysis Wars to store action to key bindings.  It also integrates with the [[joystick.cfg]] file which is used to modify joystick axis settings.  To support multiple profiles and actionmaps settings per profile, and since only one file can be named ''actionmaps.xml'' at a time, the Actionmapper only sets the currently '''Active''' one to be named ''actionmaps.xml'', while all other actionmaps configuration are stored with their name in the file.
+The Actionmapper reads and writes to the actionmaps.xml file which is used by Crysis Wars to store action to key bindings.  It also integrates with the joystick.cfg file which is used to modify joystick axis settings.  To support multiple profiles and actionmaps settings per profile, and since only one file can be named ''actionmaps.xml'' at a time, the Actionmapper only sets the currently '''Active''' one to be named ''actionmaps.xml'', while all other actionmaps configuration are stored with their name in the file.
 <br />

@@ Line 47: / Line 47: @@
 Most digital keys/buttons can be detected automatically by clicking on '''Detect Key/Button''' and then pressing the desired key/button when the dialog appears.  If the key or button is not detected and the device is properly plugged in to your computer, you may need to resort to manually selecting the key/button since the java detection libraries are not able to pick up on 100% of all possible input.
+As of 0.8.6, the Joystick Settings tab is no longer relevant as all joystick functionality must be routed through an XBox 360 emulator such as X360CE found in the [[Joystick Setup]] guide.
 === Saving ===
 When all desired changes have been made, be sure to save your modifications.  The Save function is available from the '''File''' menu.  After saving all actions marked as modified will be unmarked.
 == Setting an active Actionmaps ==
 When managing more than one actionmaps in a profile it is necessary for one of them to be active, indicating that it will be loaded the next time MWLL is run.  Use the "Set active" link at the top middle of the window for making the currently selected actionmap active.
 == Tips for new Mechwarriors ==
@@ Line 77: / Line 62: @@
 * Setting up a joystick properly requires a bit of experimentation.  If you find that the axes are too sensitive or not sensitive enough just head over to the '''Joystick Settings''' tab and fine tune to your liking.  Alternatively you may use the "raw" setting on individual axis selections on each action that will directly map to that joystick's axis response.
 == Frequently Asked Questions ==
 '''Q: Why isn't my joystick or keyboard button press being detected when I use the Detect function?'''<br />
-A: Assuming its plugged in and recognized by Windows, its very likely the detection library doesn't recognise it.  However, the button may still work in game, you will just need to manually select it using the appropriate pull-down menu for the action.
+A: Assuming its plugged in and recognized by Windows, its very likely the detection library doesn't recognise it.  However, the button may still work in game, you will just need to manually select it using the appropriate pull-down menu for the action. See the [[Joystick Setup]] guide for more info.
 '''Q: Why can't I assign Control/Alt/Shift plus a keystroke for an action, such as Control + O?'''<br />

@@ Line 11: / Line 11: @@
-[[File:Mwll-launcher-config-actionmaps.png|350px|right|thumb|'''Config Actionmaps''' button highlighted on Launcher to the left]]
+[[File:actionmapper 2.png|350px|right|thumb|Actionmapper in 0.8.6]]
 == Launching the Actionmapper ==
@@ Line 26: / Line 26: @@
 <br />
 == The first sortie ==
@@ Line 32: / Line 31: @@
 <br />
 == Conflicts ==
@@ Line 40: / Line 36: @@
 One of the first things you may notice, even with a new or default actionmaps, is the presence of conflicts indicated by red colored text and an icon with a red circle and an exclamation mark.  Some of these conflicts may be ok or may not be applicable, for instance if you do not plan to use a gamepad.  To find out which action is being conflicted with, select the action by left clicking on it.  You may clear a conflict either by setting to '''No binding''' or to another key/button that is not in use already.
-<br />
-<br />
+[[File:actionmapper.png|350px|right|thumb|Conflicts are shown in red]]
 == Modifications ==
 Each action may have up to two bindings associated with it.  Some actions are analog only, meaning only a mouse or joystick axis may be assigned and must be manually selected.  Most actions are digital only, meaning only a key or button may be assigned.  After making a selection, any action that has been modified will be indicated by blue colored text and an icon with a blue square and an uppercase M.
 [[File:Mwll-actionmapper-detect.png|350px|right|thumb|Detect Key/Button dialog while waiting input]]
 === Key/Button detection ===
@@ Line 57: / Line 48: @@
 [[File:Mwll-actionmapper-joysettings.png|350px|right|thumb|'''Joystick Settings''' for modifying joystick sensitivity and deadzones]]
 === Joystick axis settings ===
@@ Line 65: / Line 54: @@
 === Saving ===
 When all desired changes have been made, be sure to save your modifications.  The Save function is available from the '''File''' menu.  After saving all actions marked as modified will be unmarked.
 [[File:Mwll-actionmapper-setactive.png|350px|right|thumb|Link to '''Set active''' at top middle of window]]
@@ Line 83: / Line 66: @@
 [[File:Mwll-actionmapper-rightclick.png|350px|right|thumb|Right click on selected actionmaps for more options]]
 == Miscellaneous functions ==
@@ Line 92: / Line 72: @@
 == Tips for new Mechwarriors ==
@@ Line 102: / Line 78: @@
 * Setting up a joystick properly requires a bit of experimentation.  If you find that the axes are too sensitive or not sensitive enough just head over to the '''Joystick Settings''' tab and fine tune to your liking.  Alternatively you may use the "raw" setting on individual axis selections on each action that will directly map to that joystick's axis response.
 == Frequently Asked Questions ==
@@ Line 112: / Line 84: @@
 A: Assuming its plugged in and recognized by Windows, its very likely the detection library doesn't recognise it.  However, the button may still work in game, you will just need to manually select it using the appropriate pull-down menu for the action.
 '''Q: Why can't I assign Control/Alt/Shift plus a keystroke for an action, such as Control + O?'''<br />
 A: Crysis Wars does not have keystroke modifier support built-in, so MWLL cannot support it yet.
 '''Q: Why does the Xbox360 gamepad axis appear inverted in game?'''<br />
 A: The current workaround is to instead set those actions to the corresponding joystick axis instead of gamepad axis, which then will allow you to set inverse on it.  The left stick is Joystick X and Y axis, while the right stick is Joystick Rotation X and Rotation Y axis.