M MY Multiplayer: Wiki
Side
Kind

getElementBoneMatrix

Client

Returns the world matrix of a ped's or object's bone.

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

Parameters

NameTypeDescription
elementped|objectThe ped, player or object. An object needs a model with a skeleton or a node tree.
boneint|stringThe bone. On a ped: an MTA bone id, a rig bone's tag or its name. On an object: a node's name or a bone's tag.

Returns

A table of four rows of four numbers: the right, forward and up axes, then the position. false if the element is streamed out.

Example

local matrix = getElementBoneMatrix(localPlayer, 34)
if matrix then
    local position = matrix[4]
    outputDebugString(("Left hand at %.2f, %.2f, %.2f"):format(position[1], position[2], position[3]))
end
Coming from MTAIn MTA it works on peds only. Here it also takes objects and rig bones by tag or name.
NoteRaises an error if the element has no such bone. While the element is streamed out, it returns false.

See also