# setElementBoneRotation (Cliente)

> Gira un hueso de un ped u objeto respecto a su hueso padre. El cambio solo vale en este cliente.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Componentes y huesos
- **URL**: https://wiki.mymp.gg/es/setElementBoneRotation

## Sintaxis

```lua
bool setElementBoneRotation(ped|object element, int|string bone, float yaw, pitch, roll)
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `element` | `ped\|object` | El ped, jugador u objeto. Un objeto necesita un modelo con esqueleto o árbol de nodos. |
| `bone` | `int\|string` | El hueso. En un ped: un id de hueso de MTA, la tag de un hueso del rig o su nombre. En un objeto: el nombre de un nodo o la tag de un hueso. |
| `yaw, pitch, roll` | `float` | Ángulos en grados, en tres números o un `vec3`. |

## Retorno

`true` si se giró. `false` si el elemento está fuera del alcance de streaming, el hueso no tiene pose o el ped está en ragdoll.

La pose de un ped y la de un objeto animado se rehacen en cada fotograma: cámbialas en `onClientPedsProcessed`, que se dispara cuando las poses del fotograma están listas. Un objeto sin animación conserva lo que se definió. Lo que esté adjunto al hueso lo acompaña.

## Ejemplo

```lua
addEventHandler("onClientPedsProcessed", root, function()
    setElementBoneRotation(localPlayer, 5, 0, 30, 0)
end)
```

### Si vienes de MTA

En MTA solo funciona con peds. Aquí también acepta objetos y huesos del rig por tag o nombre.

### Atención

Da error si el elemento no tiene ese hueso. Mientras el elemento está fuera del alcance de streaming, devuelve `false`.

## Ver también

- [getElementBoneRotation (Cliente)](https://wiki.mymp.gg/es/getElementBoneRotation.md): Devuelve la rotación de un hueso de un ped u objeto respecto a su hueso padre, en grados.
- [setElementBoneQuaternion (Cliente)](https://wiki.mymp.gg/es/setElementBoneQuaternion.md): Define la orientación de un hueso de un ped u objeto respecto a su hueso padre, como cuaternión. El cambio solo vale en este cliente.
- [onClientPedsProcessed (Cliente)](https://wiki.mymp.gg/es/onClientPedsProcessed.md): Se dispara en cada fotograma después de animar los peds y objetos, antes de presentarlos y dibujarlos.