Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
remapping_controls_per_emulator [2023/06/16 03:14] – fix the gun2key info to properly convey its info + reorder gun2key info to be more logical + consistency with button legend atariremapping_controls_per_emulator [2024/10/31 16:04] (current) – Fix typo in a path lbrpdx
Line 44: Line 44:
 If you receive an error message saying something similar to "cannot save remap file", check for these folders: If you receive an error message saying something similar to "cannot save remap file", check for these folders:
   * ''/userdata/system/configs/retroarch/inputs/''   * ''/userdata/system/configs/retroarch/inputs/''
-  * ''/userdata/system/.config/retroarch/config/remaps/''+  * ''/userdata/system/configs/retroarch/config/remaps/''
  
 If they don't exist, create them and try again. If they don't exist, create them and try again.
Line 57: Line 57:
 You may have noticed the "Analog to Digital Type" setting. This setting is handled in //ES// as the Joystick-to-Dpad advanced system setting (or similarly named), however if you have a saved remap file then the setting in your remap file will take priority over ES's setting. You may have noticed the "Analog to Digital Type" setting. This setting is handled in //ES// as the Joystick-to-Dpad advanced system setting (or similarly named), however if you have a saved remap file then the setting in your remap file will take priority over ES's setting.
  
-Remap files are saved to ''/userdata/system/.config/retroarch/remaps/(core name)/(core/folder/game name).rmp'' (you will need to enabled "Show hidden folders/files" in your file manager to view this directory).+Remap files are saved to ''/userdata/system/configs/retroarch/remaps/(core name)/(core/folder/game name).rmp'' (you will need to enabled "Show hidden folders/files" in your file manager to view this directory).
  
 === libretro: PUAE/VICE === === libretro: PUAE/VICE ===
Line 102: Line 102:
  
 This functionality can help you create a per-game mapping of your controller to keyboard keys, in order to play games from old computers like Apple II, Sinclair or DOS and Windows games that are finicky with their joypad support. This functionality can help you create a per-game mapping of your controller to keyboard keys, in order to play games from old computers like Apple II, Sinclair or DOS and Windows games that are finicky with their joypad support.
 +
 +It can also, to some extent, be used to define additional emulator command shortcuts from the controller (such as force-closing the emulator with ''[Alt]'' + ''[F4]'', not advisable if you like having non-corrupted save data).
  
 ==== Define a system-wide pad2key mapping ==== ==== Define a system-wide pad2key mapping ====
  
-The first thing to do is to select a game and press ''[SELECT]'', go to **ADVANCED SYSTEM CONFIGURATION** and select **Create pad to keyboard configuration**.+The first thing to do is to select a game in the game list and press ''[SELECT]'', go to **ADVANCED SYSTEM CONFIGURATION** and select **Create pad to keyboard configuration**.
  
 {{ :emulators:pad2key_option.png?480 |Screenshot of the options screen}}  {{ :emulators:pad2key_option.png?480 |Screenshot of the options screen}} 
Line 125: Line 127:
 ==== Pad2key configuration file ==== ==== Pad2key configuration file ====
  
-Once your pad2key configuration is done for a specific game, it stays saved as a ''padto.keys'' or ''game_name.keys'' file next to your rom/in your Windows game directory folder. For a system-wide configuration, it'll be saved in ''/userdata/system/configs/evmapy/system-name.keys'', It is a plain JSON file with, for example:+Once your pad2key configuration is done for a specific game, it stays saved as a ''padto.keys'' or ''game_name.keys'' file next to your rom/in your Windows game directory folder. For a system-wide configuration, it'll be saved in ''/userdata/system/configs/evmapy/system-name.keys''. It is a plain JSON file with. Example:
  
     {     {
Line 157: Line 159:
       ]       ]
    }    }
 +   
 +=== Action profiles ===
 +
 +A singular keys file may contain the action profiles for multiple players. ''%%"actions_player1"%%'' will contain the actions for player 1, ''%%"actions_player2"%%'' for player 2 and so on. Each action profile contains its own unique set of triggers and targets. Example:
 +
 +<code>
 +{
 +"actions_player1": [
 +    {
 +        "trigger": [
 +            "hotkey",
 +            "start"
 +        ],
 +        "type": "key",
 +        "target": [
 +            "KEY_LEFTALT",
 +            "KEY_F4"
 +        ]
 +    },
 +    {
 +        "trigger": "up",
 +        "type": "key",
 +        "target": "KEY_UP"
 +    }
 +  ],
 +"actions_player2": [
 +    {
 +        "trigger": [
 +            "hotkey",
 +            "start"
 +        ],
 +        "type": "key",
 +        "target": [
 +            "KEY_LEFTALT",
 +            "KEY_F4"
 +        ]
 +    },
 +    {
 +        "trigger": "up",
 +        "type": "key",
 +        "target": "KEY_UP"
 +    }
 +  ]
 +}
 +</code>
 +
 +In Batocera **v37** and above, light guns can also contain their own actions. These are unique to the light guns, and thus use their own actions profile: ''%%"actions_gun1"%%''. Example:
 +
 +<code>
 +{
 +    "actions_gun1": [
 +        {
 +            "trigger": [
 +                "3",
 +                "2"
 +            ],
 +            "type": "key",
 +            "target": [
 +                "KEY_LEFTALT",
 +                "KEY_F4"
 +            ]
 +        }
 +    ]
 +}
 +</code>
  
 === Triggers === === Triggers ===
Line 194: Line 261:
 Most Batocera light guns will automatically map themselves as a virtual keyboard and pointer device, associating their ID with a particular player controller. More info on each individual light gun mapping can be found on [[emulators:lightgun_games#button_mapping_wip|the light gun page]]. Most Batocera light guns will automatically map themselves as a virtual keyboard and pointer device, associating their ID with a particular player controller. More info on each individual light gun mapping can be found on [[emulators:lightgun_games#button_mapping_wip|the light gun page]].
  
-  * Primary fire : ''%%"trigger": "BTN_LEFT"%%'' +  * Primary fire : ''%%"trigger": "left"%%'' 
-  * Secondary fire : ''%%"trigger": "BTN_RIGHT"%%'' +  * Secondary fire : ''%%"trigger": "right"%%'' 
-  * ''[START]'' : ''%%"trigger": "BTN_MIDDLE"%%'' +  * ''[START]'' : ''%%"trigger": "middle"%%'' 
-  * Aux button 1 : ''%%"trigger": "BTN_1"%%'' +  * Aux button 1 : ''%%"trigger": "1"%%'' 
-  * Aux button 2 : ''%%"trigger": "BTN_2"%%'' +  * Aux button 2 : ''%%"trigger": "2"%%'' 
-  * Aux button 3 : ''%%"trigger": "BTN_3"%%'' +  * Aux button 3 : ''%%"trigger": "3"%%'' 
-  * Aux button 4 : ''%%"trigger": "BTN_4"%%'' +  * Aux button 4 : ''%%"trigger": "4"%%'' 
-  * UP : ''%%"trigger": "BTN_5"%%'' +  * UP : ''%%"trigger": "5"%%'' 
-  * DOWN : ''%%"trigger": "BTN_6"%%'' +  * DOWN : ''%%"trigger": "6"%%'' 
-  * LEFT : ''%%"trigger": "BTN_7"%%'' +  * LEFT : ''%%"trigger": "7"%%'' 
-  * RIGHT : ''%%"trigger": "BTN_8"%%''+  * RIGHT : ''%%"trigger": "8"%%''
  
 === Targets === === Targets ===
Line 402: Line 469:
 <input name="joystick2left"  value="C Button L" /> <input name="joystick2left"  value="C Button L" />
 <input name="joystick2right" value="C Button R" /> <input name="joystick2right" value="C Button R" />
 +</inputList>
 +
 +</file>
 +
 +<file - input.xml - V38 and later>
 +<inputList>
 + <defaultInputList>
 + <input name="AnalogDeadzone" value="0,0" />
 + <input name="AnalogPeak"     value="32768,32768" />
 + <input name="l3"             value="Mempak switch" />
 + <input name="r3"             value="Rumblepak switch" />
 + <input name="a"             value="C Button R" />
 + <input name="b"             value="A Button" />
 + <input name="x"             value="C Button U" />
 + <input name="y"             value="B Button" />
 + <input name="start"         value="Start" />
 + <input name="select"         value="" />
 + <input name="pageup"         value="L Trig" />
 + <input name="pagedown"      value="R Trig" />
 + <input name="l2"             value="Z Trig" />
 + <input name="r2"             value="" />
 + <input name="up"             value="DPad U" />
 + <input name="down"           value="DPad D" />
 + <input name="right"         value="DPad R" />
 + <input name="left"           value="DPad L" />
 + <input name="joystick1up"    value="Y Axis" />
 + <input name="joystick1down"  value="Y Axis" />
 + <input name="joystick1left"  value="X Axis" />
 + <input name="joystick1right" value="X Axis" />
 + <input name="joystick2up"    value="C Button U" />
 + <input name="joystick2down"  value="C Button D" />
 + <input name="joystick2left"  value="C Button L" />
 + <input name="joystick2right" value="C Button R" />
 + </defaultInputList>
 + <!-- Alt inputs for n64 style controllers -->
 + <n64InputList>
 + <input name="AnalogDeadzone" value="0,0" />
 + <input name="AnalogPeak"     value="32768,32768" />
 + <input name="l3"             value="Mempak switch" />
 + <input name="r3"             value="Rumblepak switch" />
 + <input name="a"             value="B Button" />
 + <input name="b"             value="A Button" />
 + <input name="x"             value="C Button U" />
 + <input name="y"             value="C Button L" />
 + <input name="start"         value="Start" />
 + <input name="select"         value="Z Trig" />
 + <input name="pageup"         value="L Trig" />
 + <input name="pagedown"      value="R Trig" />
 + <input name="l2"             value="C Button D" />
 + <input name="r2"             value="C Button R" />
 + <input name="up"             value="DPad U" />
 + <input name="down"           value="DPad D" />
 + <input name="right"         value="DPad R" />
 + <input name="left"           value="DPad L" />
 + <input name="joystick1up"    value="Y Axis" />
 + <input name="joystick1down"  value="Y Axis" />
 + <input name="joystick1left"  value="X Axis" />
 + <input name="joystick1right" value="X Axis" />
 + <input name="joystick2up"    value="" />
 + <input name="joystick2down"  value="" />
 + <input name="joystick2left"  value="" />
 + <input name="joystick2right" value="" />
 + </n64InputList>
 </inputList> </inputList>
  
  • remapping_controls_per_emulator.1686885288.txt.gz
  • Last modified: 3 years ago
  • by atari