Skip to main content

R15Utils

Utility methods for R15 Characters. R15 is a specific Roblox character specification.

Functions​

searchForRigAttachment​

</>
R15Utils.searchForRigAttachment(
character: Model,
partName: string,
attachmentName: string
) → Attachment?

Searches the rig for an attachment

getRigMotor​

</>
R15Utils.getRigMotor(
character: Model,
partName: string,
motorName: string
) → AnimationConstraintOrMotor6D?

Finds a rig motor

isAnimationConstraintOrMotor6D​

</>
R15Utils.isAnimationConstraintOrMotor6D(instance: Instance) → boolean

Determines if the instance is a Motor6D or AnimationConstraint

isWeldOrAnimationConstraintOrMotor6D​

</>
R15Utils.isWeldOrAnimationConstraintOrMotor6D(instance: Instance) → boolean

Determines if the instance is a Weld, Motor6D or AnimationConstraint

getUpperTorso​

</>
R15Utils.getUpperTorso(character: Model) → BasePart?

Retrieves the upper torso

getLowerTorso​

</>
R15Utils.getLowerTorso(character: Model) → BasePart?

Retrieves the lower torso

getBodyPart​

</>
R15Utils.getBodyPart(
character: Model,
partName: string
) → BasePart?

Gets a body part for a character

getWaistJoint​

</>
R15Utils.getWaistJoint(character: Model) → AnimationConstraintOrMotor6D?

Retrieves the waist joint

getNeckJoint​

</>
R15Utils.getNeckJoint(character: Model) → AnimationConstraintOrMotor6D?

Retrieves the neck joint

getHand​

</>
R15Utils.getHand(
character: Model,
side: R15Side
) → BasePart?

Retrieves hand attachment

getGripWeld​

</>
R15Utils.getGripWeld(
character: Model,
side: R15Side
) → WeldOrAnimationConstraintOrMotor6D?

Retrieves grip weld

getGripWeldName​

</>
R15Utils.getGripWeldName(side: R15Side) → "LeftGrip" | "RightGrip"

Retrieves grip weld name for a given side

getHandName​

</>
R15Utils.getHandName(side: R15Side) → "LeftHand" | "RightHand"

Retrieves hand name for a given side

getGripAttachmentName​

</>
R15Utils.getGripAttachmentName(side: R15Side) → "LeftGripAttachment" | "RightGripAttachment"

Retrieves the grip attachment name

getShoulderRigAttachment​

</>
R15Utils.getShoulderRigAttachment(
character: Model,
side: R15Side
) → Attachment?

Retrieves the shoulder rig attachment

getGripAttachment​

</>
R15Utils.getGripAttachment(
character: Model,
side: R15Side
) → Attachment?

Retrieves the grip attachment for the given side

getExpectedRootPartYOffset​

</>
R15Utils.getExpectedRootPartYOffset(humanoid: Humanoid) → number?

Retrieves the expected root part y offset for a humanoid

getRigLength​

</>
R15Utils.getRigLength(
character: Model,
partName: string,
rigAttachment0: string,
rigAttachment1: string
) → number?

Gets the length of a segment for a rig

addLengthsOrNil​

</>
R15Utils.addLengthsOrNil(lengths: {number?}) → number?

Adds the lengths together

getUpperArmRigLength​

</>
R15Utils.getUpperArmRigLength(
character: Model,
side: R15Side
) → number?

Retrieves the upper arm length for a character

getLowerArmRigLength​

</>
R15Utils.getLowerArmRigLength(
character: Model,
side: R15Side
) → number?

Retrieves the lower arm length for a character

getWristToGripLength​

</>
R15Utils.getWristToGripLength(
character: Model,
side: R15Side
) → number?

Retrieves the wrist to hand length

getHumanoidScaleProperty​

</>
R15Utils.getHumanoidScaleProperty(
humanoid: Humanoid,
scaleValueName: string
) → number?

Retrieves the humanoid scale property

getArmRigToGripLength​

</>
R15Utils.getArmRigToGripLength(
character: Model,
side: R15Side
) → number?

Computes the length of an arm for a given character

Show raw api
{
    "functions": [
        {
            "name": "searchForRigAttachment",
            "desc": "Searches the rig for an attachment",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "partName",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "attachmentName",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "Attachment?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 19,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getRigMotor",
            "desc": "Finds a rig motor",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "partName",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "motorName",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "AnimationConstraintOrMotor6D?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 36,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "isAnimationConstraintOrMotor6D",
            "desc": "Determines if the instance is a Motor6D or AnimationConstraint",
            "params": [
                {
                    "name": "instance",
                    "desc": "",
                    "lua_type": "Instance"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "boolean\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 57,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "isWeldOrAnimationConstraintOrMotor6D",
            "desc": "Determines if the instance is a Weld, Motor6D or AnimationConstraint",
            "params": [
                {
                    "name": "instance",
                    "desc": "",
                    "lua_type": "Instance"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "boolean\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 64,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getUpperTorso",
            "desc": "Retrieves the upper torso",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "BasePart?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 71,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getLowerTorso",
            "desc": "Retrieves the lower torso",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "BasePart?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 78,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getBodyPart",
            "desc": "Gets a body part for a character",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "partName",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "BasePart?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 85,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getWaistJoint",
            "desc": "Retrieves the waist joint",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "AnimationConstraintOrMotor6D?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 101,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getNeckJoint",
            "desc": "Retrieves the neck joint",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "AnimationConstraintOrMotor6D?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 108,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getHand",
            "desc": "Retrieves hand attachment",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "BasePart?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 115,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getGripWeld",
            "desc": "Retrieves grip weld",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "WeldOrAnimationConstraintOrMotor6D?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 127,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getGripWeldName",
            "desc": "Retrieves grip weld name for a given side",
            "params": [
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "\"LeftGrip\" | \"RightGrip\"\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 144,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getHandName",
            "desc": "Retrieves hand name for a given side",
            "params": [
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "\"LeftHand\" | \"RightHand\"\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 157,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getGripAttachmentName",
            "desc": "Retrieves the grip attachment name",
            "params": [
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "\"LeftGripAttachment\" | \"RightGripAttachment\"\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 170,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getShoulderRigAttachment",
            "desc": "Retrieves the shoulder rig attachment",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "Attachment?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 183,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getGripAttachment",
            "desc": "Retrieves the grip attachment for the given side",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "Attachment?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 196,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getExpectedRootPartYOffset",
            "desc": "Retrieves the expected root part y offset for a humanoid",
            "params": [
                {
                    "name": "humanoid",
                    "desc": "",
                    "lua_type": "Humanoid"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 209,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getRigLength",
            "desc": "Gets the length of a segment for a rig",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "partName",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "rigAttachment0",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "rigAttachment1",
                    "desc": "",
                    "lua_type": "string\n"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 221,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "addLengthsOrNil",
            "desc": "Adds the lengths together",
            "params": [
                {
                    "name": "lengths",
                    "desc": "",
                    "lua_type": "{ number? }"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 243,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getUpperArmRigLength",
            "desc": "Retrieves the upper arm length for a character",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 259,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getLowerArmRigLength",
            "desc": "Retrieves the lower arm length for a character",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 277,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getWristToGripLength",
            "desc": "Retrieves the wrist to hand length",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 290,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getHumanoidScaleProperty",
            "desc": "Retrieves the humanoid scale property",
            "params": [
                {
                    "name": "humanoid",
                    "desc": "",
                    "lua_type": "Humanoid"
                },
                {
                    "name": "scaleValueName",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 303,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        },
        {
            "name": "getArmRigToGripLength",
            "desc": "Computes the length of an arm for a given character",
            "params": [
                {
                    "name": "character",
                    "desc": "",
                    "lua_type": "Model"
                },
                {
                    "name": "side",
                    "desc": "",
                    "lua_type": "R15Side"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "number?\n"
                }
            ],
            "function_type": "static",
            "source": {
                "line": 317,
                "path": "src/r15utils/src/Shared/R15Utils.lua"
            }
        }
    ],
    "properties": [],
    "types": [],
    "name": "R15Utils",
    "desc": "Utility methods for R15 Characters. R15 is a specific Roblox character specification.",
    "source": {
        "line": 7,
        "path": "src/r15utils/src/Shared/R15Utils.lua"
    }
}