---
title: "GetPlayerKeys | open.mp"
description: "Check which keys a player is pressing."
canonical: https://omp.itsneufox.com/docs/scripting/functions/GetPlayerKeys
language: en
---

# GetPlayerKeys

## Description

Check which keys a player is pressing.

| Name | Description |
| --- | --- |
| playerid | The ID of the player to get the keys of. |
| &KEY:keys | A set of bits containing the player's key states. This value is what is called a bit mask. [Click here](https://omp.itsneufox.com/docs/scripting/resources/keys) for a list of keys. |
| updown | Up/down state. |
| leftright | Left/right state. |

## Returns

The keys are stored in the specified variables.

## Examples

The following example shows how you can regularly check the up/down/left/right values using [OnPlayerUpdate](https://omp.itsneufox.com/docs/scripting/callbacks/OnPlayerUpdate).

```c
public OnPlayerUpdate(playerid)
{
    new
        KEY:keys, updown, leftright;

    GetPlayerKeys(playerid, keys, updown, leftright);

    if (updown == KEY_UP)
    {
        SendClientMessage(playerid, -1, "UP");
    }
    else if (updown == KEY_DOWN)
    {
        SendClientMessage(playerid, -1, "DOWN");
    }

    if (leftright == KEY_LEFT)
    {
        SendClientMessage(playerid, -1, "LEFT");
    }
    else if (leftright == KEY_RIGHT)
    {
        SendClientMessage(playerid, -1, "RIGHT");
    }

    return 1;
}
```

## Notes

warning

-   Only the FUNCTION of keys can be detected; not actual keys. For example, it is not possible to detect if a player presses SPACE, but you can detect if they press SPRINT (which can be mapped (assigned/binded) to ANY key (but is space by default)).
-   As of update 0.3.7, the keys "A" and "D" are not recognized when in a vehicle. However, keys "W" and "S" can be detected with the "keys" parameter.

## Related Callbacks

-   [OnPlayerKeyStateChange](https://omp.itsneufox.com/docs/scripting/callbacks/OnPlayerKeyStateChange): Called when a player's keystate changes.

## Related Resources

-   [Keys](https://omp.itsneufox.com/docs/scripting/resources/keys)