setElementBoneRotation | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setElementBoneRotation

Client-side
Server-side
Shared

Pair: getElementBoneRotation

This function sets the rotation of a specific bone relative to the element. Currently the player and ped element types are accepted.

Note

The updateElementRpHAnim must be called after this function to apply bone rotation.

Tip

Syntax 

​bool setElementBoneRotation ( ​element theElement, ​int boneId, ​float yaw, ​float pitch, ​float roll )
Required Arguments
  • theElement: The element to set the bone rotation on.
  • boneId: The ID of the bone to set the rotation of. See Bone IDs.
  • yaw: The yaw rotation value.
  • pitch: The pitch rotation value.
  • roll: The roll rotation value.

Returns

  • bool: result

Returns true if the function was successful, false otherwise.

Code Examples

client

This example shows how you can turn a local player into a so-called 'Helicopter'.

local customYaw = 0
local shoulders = {22, 32}


setTimer (function ()
    customYaw = customYaw + 20
end, 10, 0)


function changeBoneRotation ()
    local yaw, pitch, roll = getElementBoneRotation(localPlayer, 2) -- Get the element's bone rotation
    setElementBoneRotation(localPlayer, 2, customYaw, pitch, roll) -- Set the elements' bone rotation with custom yaw


    for key, value in pairs(shoulders) do
       setElementBoneRotation(localPlayer, value, 0, 0, 0) -- Update the ped's shoulders rotation
    end


    updateElementRpHAnim(localPlayer) -- Update the ped's bone animations
end
addEventHandler("onClientPedsProcessed", root, changeBoneRotation)

See Also

Element Functions
Element Events
Reference