Skip to content
Roblox API Reference

IKControl

Specifies a control to generate a procedural animation pose using Inverse Kinematics.
Memory category
Animation
Own members
18
Inherited members
75
Subclasses
0
Siblings
608

Properties34

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined byIKControl11

Property categoryBehavior

  • IKControl.ChainRoot: Instance
    The last part that you are interested in moving your character. For example, the upper arm. Must be an ancestor of EndEffector and be a BasePart or a Bone in your character.
    • Read capabilities: Animation
    • Simulation access
  • IKControl.Enabled: boolean = true
    Toggles the control on and off. True by default.
    • Read capabilities: Animation
    • Simulation access
  • IKControl.EndEffector: Instance
    The part that you are interested in moving to reach the Target. For example, the hand of your character. Must be a descendant of ChainRoot and be a BasePart or a Bone in your character.
    • Read capabilities: Animation
    • Simulation access
  • IKControl.EndEffectorOffset: CFrame = CFrame.identity
    An additional offset applied on top of the EndEffector in its local space to change where it moves.
    • Read capabilities: Animation
  • IKControl.Offset: CFrame = CFrame.identity
    An additional offset applied on top of the Target to change where the EndEffector moves.
    • Read capabilities: Animation
  • IKControl.Pole: Instance
    An optional instance that determines which way the chain bends. You can use this to specify which way an elbow or knee bends.
    • Read capabilities: Animation
  • IKControl.Priority: number = 0
    Specifies the order in which controls are solved. Higher values have higher priority.
    • Read capabilities: Animation
  • IKControl.SmoothTime: number = 0.0500000007
    Specifies the average number of seconds that it takes for the EndEffector to smoothly reach the Target.
    • Read capabilities: Animation
  • IKControl.Target: Instance
    The object that the EndEffector reaches for or points at. It can be anything that has a position in the world, such as BasePart, Attachment, Bone, or Motor6D.
    • Read capabilities: Animation
    • Simulation access
  • Specifies how the solver satisfies this control.
    • Read capabilities: Animation
    • Simulation access
  • IKControl.Weight: number = 1
    Specifies the weight of the IK control target. Should be in the [0, 1] range.
    • Read capabilities: Animation
    • Simulation access

Methods49

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined byIKControl7
  • IKControl:GetChainCount(): number
    Returns the number of segments in the IK chain between the ChainRoot and the EndEffector.
    • Capabilities: Animation
    Returns
    TypeDescription
    number
    The number of segments in the chain, or 0 if the chain isn't valid.
  • IKControl:GetChainLength(): number
    Returns the total length, in studs, of the IK chain between the ChainRoot and the EndEffector.
    • Capabilities: Animation
    Returns
    TypeDescription
    number
    The combined length of the chain in studs, or 0 if the chain isn't valid.
  • IKControl:GetNodeLocalCFrame(index: number): CFrame
    Returns the CFrame of the chain node at the given index, relative to its parent node in the chain.
    • Capabilities: Animation
    Parameters
    ParameterDescription
    index: number
    The 1-based position of the node in the chain, from 1 (the ChainRoot) up to GetChainCount() plus 1 (the EndEffector).
    Returns
    TypeDescription
    CFrame
    The node's CFrame in the local space of its parent node, or the identity CFrame if the index is out of range or the chain hasn't been solved.
  • IKControl:GetNodeWorldCFrame(index: number): CFrame
    Returns the world-space CFrame of the chain node at the given index.
    • Capabilities: Animation
    Parameters
    ParameterDescription
    index: number
    The 1-based position of the node in the chain, from 1 (the ChainRoot) up to GetChainCount() plus 1 (the EndEffector).
    Returns
    TypeDescription
    CFrame
    The node's world-space CFrame, or the identity CFrame if the index is out of range or the chain hasn't been solved.
  • IKControl:GetRawFinalTarget(): CFrame
    Returns the world-space target CFrame the solver aims for before SmoothTime smoothing is applied.
    • Capabilities: Animation
    Returns
    TypeDescription
    CFrame
    The final target CFrame, in world space, before smoothing.
  • IKControl:GetSmoothedFinalTarget(): CFrame
    Returns the world-space target CFrame the solver aims for after SmoothTime smoothing is applied.
    • Capabilities: Animation
    Returns
    TypeDescription
    CFrame
    The final target CFrame, in world space, after smoothing.
  • IKControl:Solve()
    • Roblox script security
    • Capabilities: Animation

Events10

Inherited fromObject1
Inherited fromInstance9