# engineAddEffects (Cliente)

> Registra os efeitos de partículas de um arquivo do recurso, para que `createEffect` os use por nome.

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

## Sintaxe

```lua
table|false engineAddEffects(string path [, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `path` | `string` | Caminho do arquivo de efeitos (os `<Effect>` de um XML) no recurso. |
| `priority` | `int` | Prioridade sobre efeitos de mesmo nome de outros recursos e packs. A maior vence; entre iguais, o adicionado por último. *(padrão: `0`)* |

## Retorno

Uma lista com os nomes dos efeitos adicionados, ou `false` se o arquivo não pôde ser lido.

Um efeito adicionado cobre outro de mesmo nome até ser removido ou até o recurso parar. Quando o efeito que um nome indica muda, os efeitos tocando o que foi coberto param.

## Exemplo

```lua
local names = engineAddEffects("effects/neon.xml")
if names then
    for _, name in ipairs(names) do
        outputDebugString("efeito adicionado: " .. name)
    end
end
```

### Atenção

Um arquivo sem nenhum efeito registra um aviso e devolve `false`.

## Veja também

- [engineRemoveEffects (Cliente)](https://wiki.mymp.gg/pt/engineRemoveEffects.md): Remove os efeitos que este recurso adicionou de um arquivo com engineAddEffects.
- [engineGetEffects (Cliente)](https://wiki.mymp.gg/pt/engineGetEffects.md): Lista os efeitos de partículas carregados neste cliente.
- [createEffect (Compartilhado)](https://wiki.mymp.gg/pt/createEffect.md): Cria um efeito de partículas no mundo. No servidor, todos os clientes o veem; num cliente, só esse cliente.