Skip to Content
Game ReferencesInput Mapper
Report an error
Open in ChatGPTOpen in Claude

Input Mapper

The input mapper is used with RegisterKeyMapping to create custom keybinds that players can rebind in their FiveM settings. This is the recommended way to handle custom key inputs. Use stable command names, provide clear descriptions, and select defaults that do not conflict with common GTA V or framework bindings.

Quick Usage

-- Register a custom key mapping
RegisterKeyMapping("my_command", "My Custom Action", "keyboard", "F5")
 
-- Register the associated command
RegisterCommand("my_command", function()
    print("F5 pressed! (or whatever the player rebound it to)")
end, false)
 
-- Gamepad mapping
RegisterKeyMapping("my_command", "My Custom Action", "PAD_DIGITALBUTTONANY", "LSHOULDER")
// JavaScript equivalent
RegisterKeyMapping("my_command", "My Custom Action", "keyboard", "F5");
RegisterCommand("my_command", () => {
    console.log("F5 pressed!");
});

All Input Mapper Keys

Official source · Snapshot: · Download complete JSON

26 of 26 entries

Input mapper/parameter IDs
Input MapperDescription
DIGITALBUTTON_AXISDIGITALBUTTON_AXISController button input as axis input
GAME_CONTROLLEDGAME_CONTROLLEDGame controlled input
JOYSTICK_AXISJOYSTICK_AXISJoystick / flight stick axis input
JOYSTICK_AXIS_NEGATIVEJOYSTICK_AXIS_NEGATIVEJoystick / flight stick axis input (always negative)
JOYSTICK_AXIS_POSITIVEJOYSTICK_AXIS_POSITIVEJoystick / flight stick axis input (always positive)
JOYSTICK_BUTTONJOYSTICK_BUTTONJoystick / flight stick button input
JOYSTICK_IAXISJOYSTICK_IAXISJoystick / flight stick axis input (inverted)
JOYSTICK_POVJOYSTICK_POVJoystick / flight stick point of view input
JOYSTICK_POV_AXISJOYSTICK_POV_AXISJoystick / flight stick point of view axis input
KEYBOARDKEYBOARDKeyboard input (including the Xbox Controller Chatpad)
MKB_AXISMKB_AXISMouse & keyboard input as axis input
MOUSE_ABSOLUTEAXISMOUSE_ABSOLUTEAXISMouse axis input (absolute)
MOUSE_BUTTONMOUSE_BUTTONMouse button input
MOUSE_BUTTONANYMOUSE_BUTTONANYMouse button input (no known difference from MOUSE_BUTTON)
MOUSE_CENTEREDAXISMOUSE_CENTEREDAXISMouse axis input (centered)
MOUSE_RELATIVEAXISMOUSE_RELATIVEAXISMouse axis input (relative)
MOUSE_SCALEDAXISMOUSE_SCALEDAXISMouse axis input (scaled)
MOUSE_NORMALIZEDMOUSE_NORMALIZEDMouse axis input (normalized)
MOUSE_WHEELMOUSE_WHEELMouse wheel input
PAD_ANALOGBUTTONPAD_ANALOGBUTTONController trigger input
PAD_AXISPAD_AXISController axis input
PAD_DEBUGBUTTONPAD_DEBUGBUTTONController button input (debug interface, non functional)
PAD_DIGITALBUTTONPAD_DIGITALBUTTONController button input
PAD_DIGITALBUTTONANYPAD_DIGITALBUTTONANYController button input (no known difference from PAD_DIGITALBUTTON)
TOUCHPAD_ABSOLUTE_AXISTOUCHPAD_ABSOLUTE_AXISPS4/5 controller touchpad axis input (absolute)
TOUCHPAD_CENTERED_AXISTOUCHPAD_CENTERED_AXISPS4/5 controller touchpad axis input (centered)

Source scope and usage notes

Choose the mapper first, then a parameter from that mapper’s page. These strings are not the numeric control IDs used by IsControlPressed. The source warns that mapper descriptions are inferred and that axis inputs are not currently useful in FiveM; a listed identifier is not proof that a binding works in your runtime.

Images are served from this repository, not hotlinked. Empty source fields and unknown identifiers are retained as unknown. View the official source  or download the complete dataset.

Instructional ButtonsSpeeches