# triggerServerEvent (Cliente)

> Envía un evento al servidor, que lo dispara allí en `source`. La función vuelve antes de que el servidor lo reciba.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Eventos
- **URL**: https://wiki.mymp.gg/es/triggerServerEvent

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `eventName` | `string` | Nombre del evento en el servidor. |
| `source` | `element` | Elemento que existe en el servidor. Un elemento creado solo en este cliente se rechaza. |
| `...` | `any` | Argumentos pasados a los handlers del otro lado: `nil`, booleanos, números, cadenas, elementos, vectores y tablas de ellos. Los elementos creados solo en este cliente se rechazan. |

## Retorno

`true` si el evento entró en la cola de envío, `false` si no hay conexión con un servidor, si pasa de 10 MB o si ya hay demasiados eventos esperando para salir.

En el servidor, la global `client` de los handlers es el jugador que envió el evento, y `sourceResource` es `nil`. Para más de 10 MB, usa `triggerLatentServerEvent`. El cliente envía como máximo 192 KB y 300 mensajes de eventos por segundo; el resto espera su turno.

## Ejemplo

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

### Atención

El servidor solo acepta el evento si lo registró con `addEvent(eventName, true)`. Si no, se descarta, y solo el log del servidor lo avisa.

## Ver también

- [addEvent (Compartido)](https://wiki.mymp.gg/es/addEvent.md): Registra un evento nuevo con este nombre. Solo entonces se le pueden añadir handlers y dispararlo.
- [triggerLatentServerEvent (Cliente)](https://wiki.mymp.gg/es/triggerLatentServerEvent.md): Envía un evento al servidor poco a poco, en segundo plano, a no más de bandwidth bytes por segundo. Sirve para datos grandes que no deben frenar el resto del tráfico.
- [triggerClientEvent (Servidor)](https://wiki.mymp.gg/es/triggerClientEvent.md): Envía un evento a los clientes de los jugadores, que lo disparan en source. La función vuelve antes de que los clientes lo reciban.
- [onPlayerTriggerEventThreshold (Servidor)](https://wiki.mymp.gg/es/onPlayerTriggerEventThreshold.md): Se dispara cuando un jugador llama a triggerServerEvent o triggerLatentServerEvent demasiadas veces en un intervalo. El servidor no hace nada más: qué hacer queda en manos de los scripts.
