# setElementBoneMatrix (Cliente)

> Define la matriz en el mundo de un hueso de un ped u objeto: posición, orientación y escala a la vez. 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/setElementBoneMatrix

## Sintaxis

```lua
bool setElementBoneMatrix(ped|object element, int|string bone, table matrix)
```

## 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. |
| `matrix` | `table` | Matriz en el mundo, con el formato de `getElementBoneMatrix`: cuatro filas de cuatro números. |

## Retorno

`true` si se definió, `false` si el elemento está fuera del alcance de streaming.

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()
    local matrix = getElementBoneMatrix(localPlayer, 24)
    if matrix then
        matrix[4][3] = matrix[4][3] + 0.2
        setElementBoneMatrix(localPlayer, 24, matrix)
    end
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

- [getElementBoneMatrix (Cliente)](https://wiki.mymp.gg/es/getElementBoneMatrix.md): Devuelve la matriz en el mundo de un hueso de un ped u objeto.
- [setElementBonePosition (Cliente)](https://wiki.mymp.gg/es/setElementBonePosition.md): Mueve un hueso de un ped u objeto a una posición en el mundo, conservando su orientació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.