# getControlState (Servidor)

> Diz se um jogador está pressionando um controle, segundo as teclas que o cliente dele mandou por último.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Servidor
- **Categoria**: Controles
- **URL**: https://wiki.mymp.gg/pt/getControlState-server
- **Contraparte**: Também existe no cliente, com outra implementação: [getControlState (Cliente)](https://wiki.mymp.gg/pt/getControlState-client.md)

## Sintaxe

```lua
bool getControlState(player thePlayer, string control)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `thePlayer` | `player` | O jogador. |
| `control` | `string` | O nome do controle, sem diferenciar maiúsculas. |

## Retorno

`true` se o controle está pressionado. `false` se não está, se o servidor não recebe esse controle, se o elemento não é um jogador ou se o nome do controle não existe.

Controles de veículo só contam com o jogador dentro de um veículo, e os de a pé só fora dele.

## Exemplo

```lua
setTimer(function()
    for _, player in ipairs(getElementsByType("player")) do
        if getControlState(player, "horn") then
            outputServerLog(getPlayerName(player) .. " is honking")
        end
    end
end, 1000, 0)
```

### Atenção

O servidor só recebe alguns controles. A pé: `fire`, `forwards`, `backwards`, `left`, `right`, `enter_exit`, `jump`, `sprint`, `crouch`, `action`, `walk`, `aim_weapon`, `block` e `reload`. Num veículo: `vehicle_fire`, `vehicle_secondary_fire`, `vehicle_left`, `vehicle_right`, `steer_forward`, `steer_back`, `accelerate`, `brake_reverse`, `horn`, `handbrake` e `enter_exit`. Os outros dão sempre `false`.

## Veja também

- [setControlState (Servidor)](https://wiki.mymp.gg/pt/setControlState-server.md): Pressiona ou solta um controle de um jogador como se fosse uma tecla. A ordem vai para o cliente dele, que a aplica como setControlState no jogador local.
- [isControlEnabled (Servidor)](https://wiki.mymp.gg/pt/isControlEnabled-server.md): Diz se um controle de um jogador está ligado, segundo o que o servidor mandou ao cliente dele.
- [getControlState (Cliente)](https://wiki.mymp.gg/pt/getControlState-client.md): Diz se um controle de um ped está pressionado, como forwards, fire ou accelerate.