# getElementBoneMatrix (Cliente)

> Devuelve la matriz en el mundo de un hueso de un ped u objeto.

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

## Sintaxis

```lua
table|false getElementBoneMatrix(ped|object element, int|string bone)
```

## 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. |

## Retorno

Una tabla de cuatro filas de cuatro números: los ejes derecha, adelante y arriba, y al final la posición. `false` si el elemento está fuera del alcance de streaming.

## Ejemplo

```lua
local matrix = getElementBoneMatrix(localPlayer, 34)
if matrix then
    local position = matrix[4]
    outputDebugString(("Mano izquierda en %.2f, %.2f, %.2f"):format(position[1], position[2], position[3]))
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

- [setElementBoneMatrix (Cliente)](https://wiki.mymp.gg/es/setElementBoneMatrix.md): 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.
- [getElementBonePosition (Cliente)](https://wiki.mymp.gg/es/getElementBonePosition.md): Devuelve la posición en el mundo de un hueso de un ped u objeto.
- [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.