note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
Keys
note
Here you can find information about key input constants used by GetPlayerKeys and OnPlayerKeyStateChange.
SA-MP uses bitmasking to determine which keys are pressed and which are not. Here's an article on bitmasking: http://en.wikipedia.org/wiki/Mask_(computing)
| Macro | Value | Embedding Code (On Foot) (6) | Embedding Code (In Vehicle) (6) | 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 | 512 | ~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(5) | NUM8 |
| KEY_ANALOG_DOWN | 4096 | - | ~k~~VEHICLE_TURRETDOWN~ | NUM2(5) | 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 |
(1): Key not defined in SA:MP includes. You must
#define KEY_AIM KEY_HANDBRAKE
or use KEY_HANDBRAKE.
(2): 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): Only detected when "JOYPAD" configuration is selected for controller.
(6) Embedding codes only work for client messages, textdraws and gametexts.