SetElementBonePosition: Difference between revisions

Revision as of 16:44, 6 December 2022

This function sets the position of a bone to the specified coordinates. Currently the Player and Ped element types are accepted.

[[{{{image}}}\|link=\|]]	Tip: If you want to attach an element to a bone, see attachElementToBone.

[[{{{image}}}\|link=\|]]	Note: You need to use this function together with onClientPedsProcessed.

Syntax

bool setElementBonePosition ( element theElement, int bone, float x, float y, float z )

Required Arguments

theElement: the element to set the bone position on.
bone: the ID of the bone to set the position of. See Bone IDs.
x: The X coordinate of the destination.
y: The Y coordinate of the destination.
z: The Z coordinate of the destination.

Returns

Returns true if the function was successful, false otherwise.

Example

Example preview

This example shows a surprised CJ with a long neck

local bones = {
    [4] = Vector3(0, 0, 0.15),
    [5] = Vector3(0, 0, 0.15),
    [6] = Vector3(0, 0, 0.13),
    [7] = Vector3(0, 0, 0.13),
    [8] = Vector3(0, 0, 0.1),
}
function updatePed()
    for bone,v in pairs(bones) do
        local pos = localPlayer:getBonePosition(bone)+v
        setElementBonePosition(localPlayer, bone, pos)
    end
end
addEventHandler("onClientPedsProcessed", root, updatePed)

Requirements

This template will be deleted.

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{BR/Funcao cliente}}
+{{Client function}}
 {{Added feature/item|1.5.9|1.5.8|20704|This function sets the position of a bone to the specified coordinates. Currently the [[Element/Player|Player]] and [[Element/Ped|Ped]] element types are accepted.}}
 {{Tip|If you want to attach an element to a bone, see [[attachElementToBone]].}}
@@ Line 45: / Line 45: @@
 ==See Also==
 {{Client_element_functions}}
-[[pt-br:SetElementBonePosition]]