# triggerClientEvent (Servidor)

> Envia um evento aos clientes dos jogadores, que o disparam em `source`. A função retorna antes de os clientes receberem.

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

## Sintaxe

```lua
bool triggerClientEvent(string eventName, element source, any ... [, player|table|element sendTo = root])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sendTo` | `player\|table\|element` | Um jogador, uma tabela de jogadores ou um elemento cujos jogadores descendentes recebem o evento. Se omitido, vai para todos os jogadores. Um jogador repetido recebe uma vez só. *(padrão: `root`)* |
| `eventName` | `string` | Nome do evento nos clientes. |
| `source` | `element` | Elemento onde o evento acontece nos clientes. |
| `...` | `any` | Argumentos passados aos handlers do outro lado: `nil`, booleanos, números, strings, elementos, vetores e tabelas deles. |

## Retorno

`true` se enviou, `false` se o evento passa de 10 MB ou de um milhão de valores.

Os elementos criados antes da chamada chegam aos clientes antes do evento. Para mais de 10 MB, use `triggerLatentClientEvent`.

## Exemplo

```lua
addEventHandler("onPlayerSpawn", root, function()
    triggerClientEvent(source, "onShowWelcome", source, getPlayerName(source))
end)

triggerClientEvent("onRoundStart", resourceRoot, 300)
```

### Atenção

O cliente só aceita o evento se o registrou com `addEvent(eventName, true)`. Senão ele é descartado, e só o log do cliente 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.
- [triggerLatentClientEvent (Servidor)](https://wiki.mymp.gg/pt/triggerLatentClientEvent.md): Envia um evento aos clientes dos jogadores aos poucos, em segundo plano, a no máximo bandwidth bytes por segundo para cada jogador. Serve para dados grandes que não podem segurar o resto do tráfego.
- [triggerServerEvent (Cliente)](https://wiki.mymp.gg/pt/triggerServerEvent.md): Envia um evento ao servidor, que o dispara em source lá. A função retorna antes de o servidor receber.