# addEvent (Compartido)

> Registra un evento nuevo con este nombre. Solo entonces se le pueden añadir handlers y dispararlo.

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

## Sintaxis

```lua
bool addEvent(string name [, bool allowRemoteTrigger = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `name` | `string` | Nombre del evento. |
| `allowRemoteTrigger` | `bool` | Permitir que el otro lado dispare el evento con `triggerServerEvent`, `triggerClientEvent` o sus versiones latentes. *(por defecto: `false`)* |

## Retorno

`true` si lo registró, `false` si el nombre está vacío o ya existe un evento con ese nombre.

El evento deja de existir cuando se detiene el recurso que lo registró.

## Ejemplo

```lua
addEvent("onPlayerBuyItem", true)

addEventHandler("onPlayerBuyItem", root, function(itemId)
    outputDebugString(getPlayerName(client) .. " compró el artículo " .. tostring(itemId))
end)
```

### Atención

Un evento que llega del otro lado sin `allowRemoteTrigger` se descarta, y solo una línea en el log lo avisa.

## Ver también

- [addEventHandler (Compartido)](https://wiki.mymp.gg/es/addEventHandler.md): Hace que una función se llame cada vez que el evento ocurre en el elemento indicado o, con propagate, en cualquiera de sus descendientes.
- [triggerEvent (Compartido)](https://wiki.mymp.gg/es/triggerEvent.md): Dispara un evento en este lado, en source. Los handlers del propio elemento y los de sus ancestros que propagan se llaman en el acto, antes de que la función vuelva.
- [triggerServerEvent (Cliente)](https://wiki.mymp.gg/es/triggerServerEvent.md): Envía un evento al servidor, que lo dispara allí en source. La función vuelve antes de que el servidor lo reciba.
- [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.