# addCommandHandler (Compartido)

> Registra una función que se ejecuta cuando se escribe el comando en la consola. Los argumentos llegan como textos separados por espacios.

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

## Sintaxis

```lua
bool addCommandHandler(string commandName, function handlerFunction)
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `commandName` | `string` | El nombre del comando, sin barra. Distingue mayúsculas y minúsculas. |
| `handlerFunction` | `function` | La función llamada. En el servidor recibe `(jugador, comando, ...)`, donde el jugador es la consola cuando el comando viene de la consola del servidor. En el cliente recibe `(comando, ...)`. |

## Retorno

`true` si se registró. `false` si el nombre está vacío o si este recurso ya tiene un handler para ese comando.

Varios recursos pueden atender el mismo comando, y todos se ejecutan. En el cliente, un comando que ningún script del cliente atiende se envía al servidor, donde `onPlayerCommand` se dispara antes de los handlers. Los handlers de un recurso desaparecen cuando se detiene.

## Ejemplo

```lua
addCommandHandler("vida", function(player, command, amount)
    local health = tonumber(amount)
    if health then
        setElementHealth(player, health)
    end
end)
```

## Ver también

- [removeCommandHandler (Compartido)](https://wiki.mymp.gg/es/removeCommandHandler.md): Quita el handler que este recurso registró para un comando.
- [executeCommandHandler (Servidor)](https://wiki.mymp.gg/es/executeCommandHandler-server.md): Ejecuta los handlers que los scripts del servidor registraron para un comando, como si el jugador lo hubiera escrito.
- [bindKey (Compartido)](https://wiki.mymp.gg/es/bindKey.md): Asocia una tecla a una función o a un comando. La función se ejecuta cuando la tecla se pulsa, se suelta o ambas.
- [onPlayerCommand (Servidor)](https://wiki.mymp.gg/es/onPlayerCommand.md): Se dispara cuando un jugador envía un comando al servidor, antes de que se ejecute. Cancelar el evento impide el comando.