Input mapping

All keyboard and joystick events can be mapped to any Amiga keyboard and joystick action, overriding default settings and (and the setup resulting from using the joystick_port_n options). A few examples of what you can do:

Do you want the key ‘S’ on your keyboard to press the ‘R’ key on the Amiga keyboard? You can do this with custom input mapping.
Do you want to create a setup where you can play Pinball Dreams with a gamepad? You can map game pad buttons to the Amiga keyboard F1, F2, F3, F4, cursor down, left shift and right shift keys.

General configuration

To map an action, you add a line like this to your configuration file:

devicename_eventname = actionname

Here is a specific example, mapping the keyboard key q to the fire button on the primary Amiga joystick (joy_1 is the joystick in joystick port 1):

keyboard_key_q = action_joy_1_fire_button

Input actions

Examples of input actions are:

action_joy_1_fire_button          (fire button on joystick in port 1)
action_key_z                      (press amiga keyboard key Z)
action_drive_0_insert_floppy_0    (insert disk from floppy image list)

I have put the list of available actions on its own page due to the large number of actions.

Mapping joystick events

Here are the different types of event names you can use. joystick_0 is the first joystick connected, joystick_1 is the second, etc. Similarly, you can use button_0 (first button), button_1 (second button) and so on:

joystick_0_button_0
joystick_0_axis_0_neg
joystick_0_axis_0_pos
joystick_0_hat_0_up
joystick_0_hat_0_down
joystick_0_hat_0_left
joystick_0_hat_0_right

For most game pads with a proper universal configuration, you can use universal event names instead and make the configuration work identically even with different types of game pads connected. The above configuration is not suited for this, because button numbers have generally no relation to the physical placement of the game pad buttons.

Universal event names

With universal event names, you can map these events instead:

joystick_0_dpad_left
joystick_0_dpad_right
joystick_0_dpad_up
joystick_0_dpad_down
joystick_0_lstick_left
joystick_0_lstick_right
joystick_0_lstick_up
joystick_0_lstick_down
joystick_0_lstick_button
joystick_0_rstick_left
joystick_0_rstick_right
joystick_0_rstick_up
joystick_0_rstick_down
joystick_0_rstick_button
joystick_0_south_button
joystick_0_west_button
joystick_0_north_button
joystick_0_east_button
joystick_0_start_button
joystick_0_select_button
joystick_0_left_shoulder
joystick_0_right_shoulder
joystick_0_left_trigger
joystick_0_right_trigger

Matching a joystick device

To match a specific joystick device, you can either (as in the above examples) match joystick by number:

joystick_0
joystick_1
joystick_2
etc...

Or you can match devices by name:

logitech_dual_action_usb

The device name is the name of the device as it appears in your operating system, converted to lower case and all characters other than letters and numbers converted to underscores. Adjacent underscores are merged into one, and trailing underscores are stripped.

For instance, a device named:

Controller (Xbox 360 Wireless Receiver)

will be matched by:

controller_xbox_360_wireless_receiver

If you have more than game pad of the same model connected, you can match the other ones with:

logitech_dual_action_usb_2   (the second connected of this model)
logitech_dual_action_usb_3   (the third connected of this model)
etc...

More examples

If you want to play Pinball Dreams with the first connected game pad, instead of using keyboard controls, you might want to map something like this:

joystick_0_left_shoulder = action_key_shift_left
joystick_0_right_shoulder = action_key_shift_right
joystick_0_north_button = action_key_f1
joystick_0_dpad_down = action_key_cursor_down

Along with a few more actions, such as mappings for amiga keys F2, F3, F4 and Space.

Mapping keyboard keys

See keyboard mapping.

Input mapping

117 thoughts on “Input mapping”

Jared on 2021-07-19 at 15:35 said:

Hi..

Can’t get this working yet on FS-UAE o Mac OS 10.15 (using stable release)

[config]
keyboard_key_ctrl = action_mouse_0_right

Wish to allow right mouse mapping to throw grenades in Canon Fodder

It an’t working … even if i alow Input monitoing on Mac, System Preferences. Is tis planned ? or does it work in dev. ?

Reply ↓
- FrodeSolheim on 2021-07-19 at 15:45 said:
  
  Hi, you need to use keyboard_key_lctrl or keyboard_key_rctrl.
  
  Reply ↓
TLF on 2021-05-28 at 18:24 said:

I put;
keyboard_key_q = action_key_enter
into Settings -> Advanced

Does this work or does it have to be in a config file? It’s a game that I suspect requires it but it’s not working this way.

Reply ↓
- FrodeSolheim on 2021-06-08 at 14:38 said:
  
  Hi, that should work. But please not that action_key_enter is the “keypad enter” The “main enter key” is action_key_return.
  
  Reply ↓
Tom Wright on 2020-07-09 at 21:28 said:

Hey Frode! I have a Keyrah which uses the Space key for the fire button on the main joystick so I’ve added
keyboard_key_space = action_joy_1_fire_button
to the config but that doesn’t change the space to be the fire button. I’ve tried action_joy_0_fire_button also and even tried remapping joystick 4 with the custom set but nothing works. I’ve also tried
joystick_port_1_primary = action_key_space.

What am I doing wrong here?

Reply ↓
- Tom Wright on 2020-07-09 at 21:35 said:
  
  WTH! I just tried it again with keyboard_key_space = action_joy_1_fire_button and it works perfectly! I spent all last night banging my head against the desk. I was tired.. I bet I misspelled something or something else stupid like that. So nevermind my question… I got it figured out. As always, thank so much for making FS-UAE.. it rocks!
  
  Reply ↓
  - Tom Wright on 2020-07-10 at 00:24 said:
    
    Arg… now my spacebar doesn’t work. 🙁 Let me see if there is any way to remap on the Keyrah side.
    
    Reply ↓
John on 2020-04-25 at 19:22 said:

how can i map left or right mouse buttons to a specific key?

Reply ↓
- FrodeSolheim on 2020-04-25 at 23:33 said:
  
  This is not possible in FS-UAE yet. Maybe something to put on the to-do list for 4.0…
  
  Reply ↓
- FrodeSolheim on 2020-04-25 at 23:34 said:
  
  Github issue registered: https://github.com/FrodeSolheim/fs-uae/issues/66
  
  Reply ↓
Lee on 2020-01-22 at 16:03 said:

Hello,

Is it possible to bind a mouse button to a button on my controller? For some reason when loading games I find I have to click my left mouse button to get it past the loading screen. If I could use a button on my control pad it would be so much easier. Thanks!

Reply ↓
- Lee on 2020-01-22 at 17:05 said:
  
  Please disregard my question, I achieved it by adding “XInput_Controller_Button_5 = action_joy_0_2nd_button” in the advanced settings. Everything is working perfectly now, thank you.
  
  Reply ↓
Lock on 2020-01-09 at 12:35 said:

Question: on Mac OS magic mouse it’s not possible to click both buttons at the same time.
Is there a way to map the right one to keyboard, so in case I can click them both somehow (it’s used in Cannon Fodder and other games).
Thanks

Reply ↓
- Lock on 2020-01-09 at 13:13 said:
  
  Sorry for writing in both articles, but I keep jumping here and there.
  
  Since CTRL and ALT are not reliable I’ve decided to use the two keys on the left of my right SHIFT button. they are “.” and “-“.
  
  While keyboard_key_period perfectly works, I’m not able to find the one for the other key. It should be keyboard_key_minus but doesn’t work (even the “-” on the numeric pad works”). What action should I use?
  Thanks (again).
  
  Reply ↓
  - Lock on 2020-01-09 at 13:18 said:
    
    Aarghhh, it was keyboard_key_slash !
    
    Sorry sorry sorry… problem solved. 🙂
    
    Reply ↓
Adolfo on 2019-10-12 at 13:59 said:

hi, I would like to set the joystick with no host device in place of the mouse by default so as to be able to use the keyboard mapping. I have also noticed that in the player 1, if I set the second button the lalt key does not work

Reply ↓
- FrodeSolheim on 2019-10-13 at 13:17 said:
  
  Hi, I’m not sure if I understand what you mean, can you elaborate?
  
  Reply ↓
Joel on 2019-04-26 at 12:51 said:

Hello! I would like to map Windows key to open the menu. But I can not find out how

keyboard_key_[what-to-write-here] = action_menu

Thanks!

Reply ↓
- FrodeSolheim on 2019-04-26 at 12:59 said:
  
  keyboard_key_lsuper = action_menu 🙂
  
  Reply ↓
  - Joel on 2019-04-26 at 13:02 said:
    
    It works! Thanks!
    
    Reply ↓
    - FrodeSolheim on 2019-04-26 at 13:05 said:
      
      Great 🙂 Did you get the reply by e-mail as well btw? I’m trying to figure out if messages get through or are stopped somewhere (spam filter or otherwise, it does not look like everyone gets replies by e-mails).
      
      Reply ↓
Rpone on 2019-04-11 at 22:31 said:

Hello 🙂
is it possible to do key mapping in a dedicated game settings file?
I need to change various keys but for Ishar only.
thanks

Reply ↓
- FrodeSolheim on 2019-10-13 at 16:56 said:
  
  Hi, this is possible to do if you create a local configuration for your game, but not possible for entries from the online database at the moment :-/
  
  Reply ↓

Leave a Reply Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.