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

setElementBoneRotation

Client-side
Server-side
Shared

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

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

Note

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

Tip

If you want to attach an element to a bone, see attachElementToBone .

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: value

Returns true if the function was successful, false otherwise.

Code Examples

shared

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", getRootElement(), changeBoneRotation)

See Also

Element Functions
Element Events
Reference