# triggerServerEvent (Cliente)

> Envia um evento ao servidor, que o dispara em `source` lá. A função retorna antes de o servidor receber.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Eventos
- **URL**: https://wiki.mymp.gg/pt/triggerServerEvent

## Sintaxe

```lua
bool triggerServerEvent(string eventName, element source, any ...)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `eventName` | `string` | Nome do evento no servidor. |
| `source` | `element` | Elemento que existe no servidor. Um elemento criado só neste cliente é recusado. |
| `...` | `any` | Argumentos passados aos handlers do outro lado: `nil`, booleanos, números, strings, elementos, vetores e tabelas deles. Elementos criados só neste cliente são recusados. |

## Retorno

`true` se o evento entrou na fila de envio, `false` se não há conexão com um servidor, se ele passa de 10 MB ou se já há eventos demais esperando para sair.

No servidor, a global `client` dos handlers é o jogador que enviou o evento, e `sourceResource` é `nil`. Para mais de 10 MB, use `triggerLatentServerEvent`. O cliente envia no máximo 192 KB e 300 mensagens de eventos por segundo; o resto espera a vez.

## Exemplo

```lua
bindKey("f", "down", function()
    triggerServerEvent("onPlayerBuyItem", localPlayer, 12)
end)
```

### Atenção

O servidor só aceita o evento se o registrou com `addEvent(eventName, true)`. Senão ele é descartado, e só o log do servidor avisa.

## Veja também

- [addEvent (Compartilhado)](https://wiki.mymp.gg/pt/addEvent.md): Registra um evento novo com esse nome. Só depois disso é possível adicionar handlers a ele e dispará-lo.
- [triggerLatentServerEvent (Cliente)](https://wiki.mymp.gg/pt/triggerLatentServerEvent.md): Envia um evento ao servidor aos poucos, em segundo plano, a no máximo bandwidth bytes por segundo. Serve para dados grandes que não podem segurar o resto do tráfego.
- [triggerClientEvent (Servidor)](https://wiki.mymp.gg/pt/triggerClientEvent.md): Envia um evento aos clientes dos jogadores, que o disparam em source. A função retorna antes de os clientes receberem.
- [onPlayerTriggerEventThreshold (Servidor)](https://wiki.mymp.gg/pt/onPlayerTriggerEventThreshold.md): Disparado quando um jogador chama triggerServerEvent ou triggerLatentServerEvent vezes demais num intervalo. O servidor não faz mais nada: o que fazer fica com os scripts.