# createEffect (Compartido)

> Crea un efecto de partículas en el mundo. En el servidor lo ven todos los clientes; en un cliente, solo ese cliente.

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

## Sintaxis

```lua
effect|false createEffect(string name, float x, y, z [, float rx, ry, rz = 0, 0, 0])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `name` | `string` | Nombre del efecto, como lo registró un pack o `engineAddEffects`. De 1 a 255 bytes. |
| `x, y, z` | `float` | Posición en el mundo, tres números o un vec3. |
| `rx, ry, rz` | `float` | Rotación en grados, tres números o un vec3. *(por defecto: `0, 0, 0`)* |

## Retorno

El elemento `effect` creado, o `false` si no se pudo crear. En un cliente, también `false` cuando ningún efecto tiene ese nombre.

Para que el efecto siga a un elemento, engánchalo con `attachElements`; el socket puede ser un hueso de un ped o una pieza de un vehículo u objeto. Mientras el objetivo no está cargado o el efecto está fuera de la dimensión en foco, espera y vuelve a reproducirse con el mismo color, escala y evoluciones.

Un efecto creado por un cliente se destruye cuando termina o cuando desaparece su objetivo. Un efecto del servidor queda hasta que el servidor lo destruye; un cliente que entra después no ve un efecto de una sola vez que ya terminó.

## Ejemplo

```lua
addCommandHandler("fogo", function()
    local pos = getElementPosition(localPlayer)
    local fire = createEffect("fire_large", pos.x, pos.y + 3, pos.z - 1)
    setTimer(stopEffect, 5000, 1, fire)
end)
```

### Si vienes de MTA

Solo recibe nombre, posición y rotación. El color, la escala y las evoluciones se cambian después con `setEffectColor`, `setEffectScale` y `setEffectEvolution`.

## Ver también

- [stopEffect (Compartido)](https://wiki.mymp.gg/es/stopEffect.md): Detiene un efecto: deja de emitir y las partículas que ya existen terminan.
- [setEffectColor (Compartido)](https://wiki.mymp.gg/es/setEffectColor.md): Tiñe un efecto con un color.
- [attachElements (Compartido)](https://wiki.mymp.gg/es/attachElements.md): Cuelga un elemento de otro. A partir de ahí sigue al objetivo hasta que se suelte.
- [engineAddEffects (Cliente)](https://wiki.mymp.gg/es/engineAddEffects.md): Registra los efectos de partículas de un archivo del recurso, para que createEffect los use por nombre.