Core Input Options


coin_lockout
Description This option tells Mame to emulate the coin lockout feature used on some arcade boards. What it does is prevent coin input during gameplay.
Full Command -coinlockout
Alt. Command -coinlock
Reverse Command -nocoin_lockout
-nocoinlock
Example mame64.exe pacman -coin_lockout
Mame.ini Command coin_lockout
Command Default 1
Argument Format <boolean>

ctrlr
Description This option loads a custom controller configuration. These files are stored in the ctrlr folder and contain custom button and axis information. You can find a page on ctrlr file on the External Files page.
Full Command -ctrlr <filename>
Alt. Command none
Reverse Command none
Example mame64.exe pacman -ctrlr hotrodse
Mame.ini Command ctrlr
Command Default none
Argument Format <filename>

mouse
Description Enables / Disables mouse support in Mame.
Full Command -mouse
Alt. Command none
Reverse Command -nomouse
Example mame64.exe opwolf -mouse
Mame.ini Command mouse
Command Default 0
Argument Format <boolean>

joystick
Description Enabled / Disable joystick support in Mame.
Full Command -joystick
Alt. Command -joy
Reverse Command -nojoystick
-nojoy
Example mame64.exe pacman -nojoystick
Mame.ini Command joystick
Command Default 1
Argument Format <boolean>

lightgun
Description Enables / Disables lightgun support in Mame.
Full Command -lightgun
Alt. Command -gun
Reverse Command -nolightgun
-nogun
Example mame64.exe opwolf -lightgun
Mame.ini Command lightgun
Command Default 0
Argument Format <boolean>

multikeyboard
Description This option enables support for more than one keyboard.
Full Command -multikeyboard
Alt. Command -multikey
Reverse Command -nomultikeyboard
-nomultikey
Example mame64.exe ddragon -multikeyboard
Mame.ini Command multikeyboard
Command Default 0
Argument Format <boolean>

multimouse
Description This option enables support for more than one mouse.
Full Command -multimouse
Alt. Command none
Reverse Command none
Example mame64.exe opwolf -multimouse
Mame.ini Command multimouse
Command Default 0
Argument Format <boolean>

steadykey
Description Steadykey is used if you have problems when multiple keys are pressed at the same time.
Full Command -steadykey
Alt. Command -steady
Reverse Command -nosteadykey
-nosteady
Example mame64.exe sf2 -steadykey
Mame.ini Command steadykey
Command Default 0
Argument Format <boolean>

ui_active
Description Allows the showing of the Mame user interface on top of an emulated keyboard (if present).
Full Command -ui_active
Alt. Command none
Reverse Command -noui_active
Example mame64.exe pacman -ui_active
Mame.ini Command ui_active
Command Default 0
Argument Format <boolean>

offscreen_reload
Description This option will allow you to use a second button on a lightgun as the reload signal instead of having to move the cursor off the screen.
Full Command -offscreen_reload
Alt. Command -reload
Reverse Command -nooffscreen_reload
-noreload
Example mame64.exe area51 -offscreen_reload
Mame.ini Command offscreen_reload
Command Default 0
Argument Format <boolean>

joystick_map
Description

Sorry I'm cheating by using the description of the Mame documentation as it explains this command quite well.

What this command does is control how joystick values map to digital joystick controls. Mame accepts all joystick input from the system as analog data. For true analog joysticks, this needs to be mapped down to the usual 4-way or 8-way digital joystick values. To do this, Mame divides the analog range into a 9x9 grid. It then takes the joystick axis position (for X and Y axes only), maps it to this grid, and then looks up a translation from a joystick map.

Maps are defined as a string of numbers and characters. Since the grid is 9x9, there are a total of 81 characters necessary to define a complete map.

Below is an example map for an 8-way joystick:

777888999 Note that the numeric digits correspond to the keys
777888999 on a numeric keypad. So '7' maps to up+left, '4' maps
777888999 to left, '5' maps to neutral, etc. In addition to the
444555666 numeric values, you can specify the character 's',
444555666 which means "sticky". In this case, the value of the
444555666 map is the same as it was the last time a non-sticky
111222333 value was read.
111222333
111222333

To specify the map for this parameter, you can specify astring of rows separated by a‘.’ (which indicates the end of a row), like so...

777888999.777888999.777888999.444555666.444555666.444555666.111222333.111222333.111222333

There is a really complicated way to shorten the string by using a special shorthand. This is explained in the Mame documentation.

Full Command -joystick_map <custom>
Alt. Command -joymap
Reverse Command none
Example mame64.exe pacman -joymap 777888999.777888999.777888999.444555666.444555666.444555666.111222333.111222333.111222333
Mame.ini Command joystick_map
Command Default auto
Argument Format <custom>.<custom>.<custom>

joystick_deadzone
Description Analog joysticks sometimes don't center properly so a dead area can be made where no movement will be detected. The values of this option can be between 0.0 and 1.0 where 0.0 is the center position of the joystick and 1.0 is the outer limit.
Full Command -joystick_deadzone <float>
Alt. Command -joy_deadzone
-jdz
Reverse Command none
Example mame64.exe pacman -joystick_deadzone 0.5
Mame.ini Command joystick_deadzone
Command Default 0.3
Argument Format <float>

joystick_saturation
Description Analog joystick sometimes don't give an even range of motion. With this option you can set where Mame will stop reading the joysticks movement along each axis. The values of this option can be between 0.0 and 1.0 where 0.0 is the center position of the joystick and 1.0 is the outer limit.
Full Command -joystick_saturation <float>
Alt. Command -joy_saturation
-jsat
Reverse Command none
Example mame64.exe aburner -joystick_saturation 0.6
Mame.ini Command joystick_saturation
Command Default 0.85
Argument Format <float>

natural
Description This option allow the support for non QWERTY keyboards by matching the key pressed to the expected key needed in Mame. For example, if you have a keyboard with a "z" in a different place to a QWERTY keyboard, Mame will treat the keypress as if it was pressed on the QWERTY keyboard.
Full Command -natural
Alt. Command none
Reverse Command none
Example mame64.exe spectrum -natural
Mame.ini Command natural
Command Default 0
Argument Format <boolean>

joystick_contradictory
Description This option allows the use of contradictory joystick movements. e.g. Up & Down or Left & Right at the same time.
Full Command -joystick_contradictory
Alt. Command none
Reverse Command none
Example mame64.exe pacman -joystick_contradictory
Mame.ini Command joystick_contradictory
Command Default 0
Argument Format <boolean>

coin_impulse
Description This option tells Mame how to handle coin slot impules on systems. There are three possible options...

  • n<0 - Disable the impulse.
  • n==0 - Obey driver default value
  • 0<n - Set the time value specified by n
Full Command -coin_impulse <custom>
Alt. Command none
Reverse Command none
Example mame64.exe pacman -coin_impulse n==0
Mame.ini Command coin_impulse
Command Default 0
Argument Format <custom>