# toggleControl (Servidor)

> Liga ou desliga um controle de um jogador. O cliente dele deixa de passar esse controle ao jogo, mesmo com a tecla pressionada.

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

## Sintaxe

```lua
bool toggleControl(player thePlayer, string control, bool enabled)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `thePlayer` | `player` | O jogador. |
| `control` | `string` | O nome do controle, sem diferenciar maiúsculas. |
| `enabled` | `bool` | `true` para ligar, `false` para desligar. |

## Retorno

`true` se a ordem foi enviada ao cliente. `false` se o elemento não é um jogador ou se o nome do controle não existe.

O servidor guarda o estado que mandou, que `isControlEnabled` devolve depois.

## Exemplo

```lua
addEventHandler("onPlayerVehicleEnter", root, function(vehicle)
    toggleControl(source, "vehicle_fire", false)
    toggleControl(source, "vehicle_secondary_fire", false)
end)
```

### Vindo do MTA

Além dos controles do MTA, o MYMP tem `block` (bloquear no corpo a corpo) e `reload` (recarregar).

## Veja também

- [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.
- [toggleAllControls (Servidor)](https://wiki.mymp.gg/pt/toggleAllControls-server.md): Liga ou desliga de uma vez todos os controles de um jogador. A ordem vai para o cliente dele.
- [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.
- [toggleControl (Cliente)](https://wiki.mymp.gg/pt/toggleControl-client.md): Liga ou desliga um controle do jogador local. Um controle desligado não chega ao jogo, mesmo com a tecla pressionada.
