# getElementVelocity (Compartilhado)

> Devolve a velocidade de um elemento.

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

## Sintaxe

```lua
vec3|false getElementVelocity(element element)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | O elemento: um ped, jogador, veículo ou objeto. |

## Retorno

Um `vec3` com a velocidade em unidades por passo de simulação, ou `false` se o elemento não tem velocidade.

## Exemplo

```lua
local vehicle = getPedOccupiedVehicle(localPlayer)
if vehicle then
    local velocity = getElementVelocity(vehicle)
    local speed = math.sqrt(velocity.x ^ 2 + velocity.y ^ 2 + velocity.z ^ 2)
    outputDebugString(("speed: %.3f"):format(speed))
end
```

## Veja também

- [setElementVelocity (Compartilhado)](https://wiki.mymp.gg/pt/setElementVelocity.md): Define a velocidade de um elemento.
- [getElementAngularVelocity (Compartilhado)](https://wiki.mymp.gg/pt/getElementAngularVelocity.md): Lê a velocidade de giro de um elemento em cada eixo, por passo da simulação.
- [getElementPosition (Compartilhado)](https://wiki.mymp.gg/pt/getElementPosition.md): Lê a posição de um elemento no mundo.