# setPedAnimation (Cliente)

> Faz um ped tocar uma animação de um bloco, ou para a animação que ele está tocando. A animação vale só neste cliente.

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

## Sintaxe

```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

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `ped` | `element` | O ped ou jogador. Um elemento com peds abaixo dele na árvore aplica a todos eles. |
| `block` | `string\|false` | Nome do bloco de animações. `false` ou omitido junto com `anim` para a animação. *(padrão: `nil`)* |
| `anim` | `string` | Nome da animação dentro do bloco. Sem ele, a animação atual para. *(padrão: `nil`)* |
| `time` | `int` | Por quanto tempo a animação roda, em milissegundos. `-1` não tem limite. *(padrão: `-1`)* |
| `loop` | `bool` | Repetir a animação. *(padrão: `true`)* |
| `updatePosition` | `bool` | Deixar a animação mover o ped pelo mundo. *(padrão: `true`)* |
| `interruptible` | `bool` | Deixar que reações do jogo, como levar um empurrão, interrompam a animação. *(padrão: `true`)* |
| `freezeLastFrame` | `bool` | Parar no último quadro em vez de sair da animação quando ela termina. *(padrão: `true`)* |
| `blendTime` | `int` | Tempo de transição para a animação, em milissegundos. *(padrão: `250`)* |
| `restoreTask` | `bool` | Se o ped estava agachado, voltar a agachar quando a animação acabar. *(padrão: `false`)* |

## Retorno

`true` se a animação começou ou parou no elemento passado, `false` se o bloco não existe ou o elemento não é um ped.

A animação fica guardada enquanto o ped está fora do alcance de streaming e volta no ponto certo quando ele reaparece.

## Exemplo

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

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

## Veja também

- [getPedAnimation (Cliente)](https://wiki.mymp.gg/pt/getPedAnimation.md): Diz qual animação de setPedAnimation um ped está tocando neste cliente.
- [setPedAnimationSpeed (Cliente)](https://wiki.mymp.gg/pt/setPedAnimationSpeed.md): Muda a velocidade de uma animação que o ped está tocando.
- [setPedAnimationProgress (Cliente)](https://wiki.mymp.gg/pt/setPedAnimationProgress.md): Pula uma animação que o ped está tocando para um ponto dela. Sem anim, para a animação de setPedAnimation.