# setElementVelocity (Compartilhado)

> Define a velocidade de um elemento.

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

## Sintaxe

```lua
bool setElementVelocity(element element, float x, y, z)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | O ped, jogador, veículo ou objeto. |
| `x, y, z` | `float` | Velocidade em cada eixo, em unidades por passo de simulação. |

## Retorno

`true` se definiu, `false` se o elemento não tem velocidade.

## Exemplo

```lua
bindKey("space", "down", function()
    local vehicle = getPedOccupiedVehicle(localPlayer)
    if vehicle then
        local velocity = getElementVelocity(vehicle)
        setElementVelocity(vehicle, velocity.x, velocity.y, velocity.z + 0.3)
    end
end)
```

## Veja também

- [getElementVelocity (Compartilhado)](https://wiki.mymp.gg/pt/getElementVelocity.md): Devolve a velocidade de um elemento.
- [setElementAngularVelocity (Compartilhado)](https://wiki.mymp.gg/pt/setElementAngularVelocity.md): Define a velocidade de giro de um elemento.
- [setElementFrozen (Compartilhado)](https://wiki.mymp.gg/pt/setElementFrozen.md): Congela ou descongela um elemento e todos os seus filhos.