# addCommandHandler (Compartilhado)

> Registra uma função que roda quando o comando é digitado no console. Os argumentos chegam como textos separados por espaço.

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `commandName` | `string` | O nome do comando, sem barra. Maiúsculas e minúsculas contam. |
| `handlerFunction` | `function` | A função chamada. No servidor recebe `(jogador, comando, ...)`, onde o jogador é o console quando o comando vem do console do servidor. No cliente recebe `(comando, ...)`. |

## Retorno

`true` se registrou. `false` se o nome está vazio ou se este recurso já tem um handler para esse comando.

Vários recursos podem tratar o mesmo comando, e todos rodam. No cliente, um comando que nenhum script do cliente trata é enviado ao servidor; lá `onPlayerCommand` dispara antes dos handlers. Os handlers de um recurso somem quando ele para.

## Exemplo

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

## Veja também

- [removeCommandHandler (Compartilhado)](https://wiki.mymp.gg/pt/removeCommandHandler.md): Remove o handler que este recurso registrou para um comando.
- [executeCommandHandler (Servidor)](https://wiki.mymp.gg/pt/executeCommandHandler-server.md): Roda os handlers que os scripts do servidor registraram para um comando, como se o jogador o tivesse digitado.
- [bindKey (Compartilhado)](https://wiki.mymp.gg/pt/bindKey.md): Liga uma tecla a uma função ou a um comando. A função roda quando a tecla é apertada, solta ou os dois.
- [onPlayerCommand (Servidor)](https://wiki.mymp.gg/pt/onPlayerCommand.md): Disparado quando um jogador manda um comando ao servidor, antes de ele rodar. Cancelar o evento impede o comando.