# getElementVelocity (Compartido)

> Devuelve la velocidad de un elemento.

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

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `element` | `element` | El elemento: un ped, jugador, vehículo u objeto. |

## Retorno

Un `vec3` con la velocidad en unidades por paso de simulación, o `false` si el elemento no tiene velocidad.

## Ejemplo

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

## Ver también

- [setElementVelocity (Compartido)](https://wiki.mymp.gg/es/setElementVelocity.md): Define la velocidad de un elemento.
- [getElementAngularVelocity (Compartido)](https://wiki.mymp.gg/es/getElementAngularVelocity.md): Lee la velocidad de giro de un elemento en cada eje, por paso de la simulación.
- [getElementPosition (Compartido)](https://wiki.mymp.gg/es/getElementPosition.md): Lee la posición de un elemento en el mundo.