# setPedAnimation (Cliente)

> Hace que un ped reproduzca una animación de un bloque, o detiene la animación que está reproduciendo. La animación solo vale en este cliente.

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

## Sintaxis

```lua
bool setPedAnimation(element ped [, string|false block = nil, string anim = nil, int time = -1, bool loop = true, bool updatePosition = true, bool interruptible = true, bool freezeLastFrame = true, int blendTime = 250, bool restoreTask = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `ped` | `element` | El ped o jugador. Un elemento con peds debajo en el árbol la aplica a todos ellos. |
| `block` | `string\|false` | Nombre del bloque de animaciones. `false` u omitido junto con `anim` detiene la animación. *(por defecto: `nil`)* |
| `anim` | `string` | Nombre de la animación dentro del bloque. Sin él, la animación actual se detiene. *(por defecto: `nil`)* |
| `time` | `int` | Cuánto dura la animación, en milisegundos. `-1` no tiene límite. *(por defecto: `-1`)* |
| `loop` | `bool` | Repetir la animación. *(por defecto: `true`)* |
| `updatePosition` | `bool` | Dejar que la animación mueva al ped por el mundo. *(por defecto: `true`)* |
| `interruptible` | `bool` | Dejar que las reacciones del juego, como recibir un empujón, interrumpan la animación. *(por defecto: `true`)* |
| `freezeLastFrame` | `bool` | Quedarse en el último fotograma en lugar de salir de la animación cuando termina. *(por defecto: `true`)* |
| `blendTime` | `int` | Tiempo de transición hacia la animación, en milisegundos. *(por defecto: `250`)* |
| `restoreTask` | `bool` | Si el ped estaba agachado, volver a agacharse cuando termine la animación. *(por defecto: `false`)* |

## Retorno

`true` si la animación empezó o se detuvo en el elemento dado, `false` si el bloque no existe o el elemento no es un ped.

La animación se guarda mientras el ped está fuera del alcance de streaming y continúa en el punto correcto cuando vuelve.

## Ejemplo

```lua
addCommandHandler("dance", function()
    setPedAnimation(localPlayer, "DANCING", "dance_loop")
end)

addCommandHandler("stopanim", function()
    setPedAnimation(localPlayer)
end)
```

## Ver también

- [getPedAnimation (Cliente)](https://wiki.mymp.gg/es/getPedAnimation.md): Indica qué animación de setPedAnimation reproduce un ped en este cliente.
- [setPedAnimationSpeed (Cliente)](https://wiki.mymp.gg/es/setPedAnimationSpeed.md): Cambia la velocidad de una animación que el ped reproduce.
- [setPedAnimationProgress (Cliente)](https://wiki.mymp.gg/es/setPedAnimationProgress.md): Salta una animación que el ped reproduce a un punto de ella. Sin anim, detiene la animación de setPedAnimation.