# getElementAngularVelocity (Shared)

> Reads how fast an element turns about each axis, per simulation step.

- **Platform**: MY Multiplayer (MYMP)
- **Kind**: Lua Function
- **Side**: Shared
- **Category**: Elements
- **URL**: https://wiki.mymp.gg/en/getElementAngularVelocity

## Syntax

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

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `element` | `element` | The element to read. |

## Returns

A `vec3` with the turn speed, or `false` if the element does not turn (it is not physical).

## Example

```lua
local vehicle = getPedOccupiedVehicle(localPlayer)
if vehicle then
    local spin = getElementAngularVelocity(vehicle)
    outputDebugString(("spin: %.3f"):format(spin.z))
end
```

### Coming from MTA

In MTA this function is called `getElementTurnVelocity`.

## See also

- [setElementAngularVelocity (Shared)](https://wiki.mymp.gg/en/setElementAngularVelocity.md): Sets an element's turning speed.
- [getElementVelocity (Shared)](https://wiki.mymp.gg/en/getElementVelocity.md): Returns an element's velocity.