Keys


Here you can find information about key input constants in UG-MP. These constants are used by natives such as GetPlayerKeys. SA-MP (and UG-MP too, obviously) uses bitmasking to determine which keys are pressed and which are not. Here's an article on bitmasking: https://en.wikipedia.org/wiki/Mask_(computing)

Macro Value Embedding Code (On Foot) (7) Embedding Code (In Vehicle) (7) Default Key (On Foot) Default Key (In Vehicle)
KEY_ACTION 1 ~k~~PED_ANSWER_PHONE~ ~k~~VEHICLE_FIREWEAPON_ALT~ TAB ALT GR / LCTRL / NUM0
KEY_CROUCH 2 ~k~~PED_DUCK~ ~k~~VEHICLE_HORN~ C H / CAPSLOCK
KEY_FIRE 4 ~k~~PED_FIREWEAPON~ ~k~~VEHICLE_FIREWEAPON~ LCTRL / LMB (Left Mouse Button) LALT
KEY_SPRINT 8 ~k~~PED_SPRINT~ ~k~~VEHICLE_ACCELERATE~ SPACE W
KEY_SECONDARY_ATTACK 16 ~k~~VEHICLE_ENTER_EXIT~ ~k~~VEHICLE_ENTER_EXIT~ ENTER ENTER
KEY_JUMP 32 ~k~~PED_JUMPING~ ~k~~VEHICLE_BRAKE~ LSHIFT S
KEY_LOOK_RIGHT 64 - ~k~~VEHICLE_LOOKRIGHT~ - E
KEY_HANDBRAKE/KEY_AIM(1) 128 ~k~~PED_LOCK_TARGET~ ~k~~VEHICLE_HANDBRAKE~ RMB (Right Mouse Button) SPACE
KEY_LOOK_LEFT 256 - ~k~~VEHICLE_LOOKLEFT~ - Q
KEY_LOOK_BEHIND 320(5) ~k~~PED_LOOKBEHIND~ ~k~~VEHICLE_LOOKBEHIND~ NUM1 / MMB (Middle Mouse Button - Click the mouse wheel) 2
KEY_SUBMISSION 512 - ~k~~TOGGLE_SUBMISSIONS~ NUM1 / MMB (Middle Mouse Button - Click the mouse wheel) 2 / NUMPAD +
KEY_WALK 1024 ~k~~SNEAK_ABOUT~ - LALT -
KEY_ANALOG_UP 2048 - ~k~~VEHICLE_TURRETUP~ NUM8(6) NUM8
KEY_ANALOG_DOWN 4096 - ~k~~VEHICLE_TURRETDOWN~ NUM2(6) NUM2
KEY_ANALOG_LEFT 8192 ~k~~VEHICLE_LOOKLEFT~ ~k~~VEHICLE_TURRETLEFT~ NUM4 NUM4
KEY_ANALOG_RIGHT 16384 ~k~~VEHICLE_LOOKRIGHT~ ~k~~VEHICLE_TURRETRIGHT~ NUM6 NUM6
KEY_YES(2) 65536 ~k~~CONVERSATION_YES~ ~k~~CONVERSATION_YES~ Y Y
KEY_NO(2) 131072 ~k~~CONVERSATION_NO~ ~k~~CONVERSATION_NO~ N N
KEY_CTRL_BACK(2) 262144(4) ~k~~GROUP_CONTROL_BWD~ ~k~~GROUP_CONTROL_BWD~ H H
UNDEFINED(3) - ~k~~GROUP_CONTROL_FWD~ ~k~~GROUP_CONTROL_FWD~ G G
KEY_UP -128 ~k~~GO_FORWARD~ ~k~~VEHICLE_STEERUP~ UP UP
KEY_DOWN 128 ~k~~GO_BACK~ ~k~~VEHICLE_STEERDOWN~ DOWN DOWN
KEY_LEFT -128 ~k~~GO_LEFT~ ~k~~VEHICLE_STEERLEFT~ LEFT LEFT
KEY_RIGHT 128 ~k~~GO_RIGHT~ ~k~~VEHICLE_STEERRIGHT~ RIGHT RIGHT

Notes

  • (1): Key not defined in SA:MP includes. You must define this yourself or use KEY_HANDBRAKE.
  • (2): Supported since 0.3d. Not detectable in earlier versions. This key can not be detected when the player is in spectator mode.
  • (3): GROUP_CONTROL_FWD cannot be detected in SA-MP, as it used internally to enter vehicles as passenger. However, the gametext definition still exists.
  • (4): If the key number "262144" does not work, just use key number "2".
  • (5): This value is the sum of KEY_LOOK_LEFT and KEY_LOOK_RIGHT.
  • (6): Only detected when "JOYPAD" configuration is selected for controller.
  • (7): Embedding codes only work for client messages, textdraws and gametexts.