# engineAddEffects (Cliente)

> Registra los efectos de partículas de un archivo del recurso, para que `createEffect` los use por nombre.

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

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `path` | `string` | Ruta del archivo de efectos (los `<Effect>` de un XML) en el recurso. |
| `priority` | `int` | Prioridad sobre efectos del mismo nombre de otros recursos y packs. Gana la mayor; entre iguales, el añadido por último. *(por defecto: `0`)* |

## Retorno

Una lista con los nombres de los efectos añadidos, o `false` si no se pudo leer el archivo.

Un efecto añadido cubre a otro del mismo nombre hasta que se quita o el recurso se detiene. Cuando cambia el efecto al que apunta un nombre, los efectos que reproducían el cubierto se detienen.

## Ejemplo

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

### Atención

Un archivo sin ningún efecto registra un aviso y devuelve `false`.

## Ver también

- [engineRemoveEffects (Cliente)](https://wiki.mymp.gg/es/engineRemoveEffects.md): Quita los efectos que este recurso añadió desde un archivo con engineAddEffects.
- [engineGetEffects (Cliente)](https://wiki.mymp.gg/es/engineGetEffects.md): Lista los efectos de partículas cargados en este cliente.
- [createEffect (Compartido)](https://wiki.mymp.gg/es/createEffect.md): Crea un efecto de partículas en el mundo. En el servidor lo ven todos los clientes; en un cliente, solo ese cliente.