Describes the appearance of a Humanoid character including body parts, accessories, colors, scales, animations, and emotes.
- Memory category
- Instances
- Own members
- 55
- Inherited members
- 75
- Subclasses
- 0
- Siblings
- 608
Properties68
Property categoryBehavior
- Determines if an
Instanceand its descendants can be cloned usingInstance:Clone(), and can be saved/published. - Deprecated: This deprecated property is a variant of
Instance.Archivablewhich should be used instead.Use Archivable instead.
Property categoryData
Property categoryPermissions
- The set of capabilities allowed to be used for scripts inside this container.
- Indicates whether the instance is inside a sandboxed container.
- When enabled, the instance can only access abilities in its
Capabilitieslist.
Defined byHumanoidDescription45
Property categoryAccessories
HumanoidDescription.AccessoryBlob: string = "[]" A JSON formatted array of Layered clothing where each table in the entry in the array describes an accessory's AssetId, AccessoryType, Order, and (optionally) Puffiness as key-value pairs.HumanoidDescription.BackAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its back (such as capes).HumanoidDescription.FaceAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to the front of its face (such as glasses).HumanoidDescription.FrontAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to front of its torso (such as medals or ties).HumanoidDescription.HairAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its head resembling hair.HumanoidDescription.HatAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its head.HumanoidDescription.NeckAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its neck (such as scarves or necklaces).HumanoidDescription.ShouldersAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its shoulders (such as shoulder-mounted critters).HumanoidDescription.WaistAccessory: string = "" A comma-separated list of asset IDs that will be added asAccessoriesto aHumanoidrig whenapplied, usually those attached to its waist (such as belts).
Property categoryAnimation
HumanoidDescription.ClimbAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisClimbing.HumanoidDescription.FallAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisFreefall.HumanoidDescription.IdleAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisRunningat a speed near zero.HumanoidDescription.JumpAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisJumping.HumanoidDescription.MoodAnimation: number = 0 When this description isappliedto aHumanoid, this determines the asset ID of the mood animation that gives the character's face its persistent expression.HumanoidDescription.NumberEmotesLoaded: number = -1 HumanoidDescription.RunAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisRunningat a moderate speed.HumanoidDescription.StaticFacialAnimation: boolean = false Whentrue, disables facial animations on a Dynamic Head, displaying a static mood pose instead. Defaults tofalse.HumanoidDescription.SwimAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisSwimming.HumanoidDescription.WalkAnimation: number = 0 When this description isappliedto aHumanoid, this determines theAnimation.AnimationIdto play when itsstateisRunningat a low speed.
Property categoryBody Colors
- Determines the
BodyColors.RightArmColor3andBodyColors.RightArmColorof a Humanoid when applied. - Determines the
BodyColors.RightLegColor3andBodyColors.RightLegColorof a Humanoid when applied. - Determines the
BodyColors.TorsoColor3andBodyColors.TorsoColorof a Humanoid when applied.
Property categoryBody Parts
HumanoidDescription.Face: number = 0 Determines the asset ID of the Face to be applied to theHumanoid.HumanoidDescription.Head: number = 0 Determines the asset ID of the Head to be applied to theHumanoid.HumanoidDescription.LeftArm: number = 0 Determines the asset ID of the LeftArm to be applied to theHumanoid.HumanoidDescription.LeftLeg: number = 0 Determines the asset ID of the LeftLeg to be applied to theHumanoid.HumanoidDescription.RightArm: number = 0 Determines the asset ID of the RightArm to be applied to theHumanoid.HumanoidDescription.RightLeg: number = 0 Determines the asset ID of the RightLeg to be applied to theHumanoid.HumanoidDescription.Torso: number = 0 Determines the asset ID of the Torso to be applied to theHumanoid.
Property categoryClothes
Property categoryData
HumanoidDescription.EmotesDataInternal: string = "" HumanoidDescription.EquippedEmotesDataInternal: string = "" HumanoidDescription.ResetIncludesBodyParts: boolean = true HumanoidDescription.UseAvatarSettings: boolean = false Whentrue, applying this description also applies the experience's Avatar Settings to the resulting model. Defaults tofalse.
Property categoryScale
HumanoidDescription.BodyTypeScale: number = 0.300000012 Determines the factor by which the shape of aHumanoidis interpolated from the standard R15 body shape (0) to a taller and more slender body type (1).HumanoidDescription.DepthScale: number = 1 Determines by what factor the depth (back-to-front distance) of aHumanoidis scaled.HumanoidDescription.HeadScale: number = 1 Determines by what factor the Head object of aHumanoidis scaled, as well as any accessories attached to it.HumanoidDescription.HeightScale: number = 1 Determines by what factor the height (top-to-bottom distance) of aHumanoidis scaled, as well as all accessories not attached to its head.HumanoidDescription.ProportionScale: number = 1 Determines how wide (0) or narrow (1) aHumanoidrig is.HumanoidDescription.WidthScale: number = 1 Determines by what factor the width (left-to-right distance) of aHumanoidis scaled, as well as all accessories not attached to its head.
No properties match the filters.
Methods50
Object:GetPropertyChangedSignal( property: string): RBXScriptSignal Get an event that fires when a given property of the object changes.Parameters Parameter Description property: stringThe property to connect to.Returns Type Description RBXScriptSignalA signal that fires whenever the property changes.- Returns true if an object's class matches or inherits from a given class.
Parameters Parameter Description className: stringThe class against which the Object's class will be checked. Case-sensitive.Returns Type Description booleanDescribes whether the Object's class matched or is a subclass of the given class. - Deprecated: This deprecated function is a variant of
Object:IsA()which should be used instead.Parameters Parameter className: stringReturns Type booleanUse IsA instead.
- Applies a tag to the instance.
Parameters Parameter Description tag: stringThe tag to apply to the instance. - This method destroys all of an instance's children.
- Create a copy of an instance and all its descendants, ignoring instances that are not
Archivable.Returns Type Description InstanceA copy of the instance, ornilif the instance is notArchivable. - Sets the
Instance.Parentproperty tonil, locks theInstance.Parentproperty, disconnects all connections, and callsDestroy()on all children. Instance:FindFirstAncestor( name: string): Instance Returns the first ancestor of theInstancewhoseInstance.Nameis equal to the given name.Parameters Parameter Description name: stringTheInstance.Nameto be looked for.Instance:FindFirstAncestorOfClass( className: string): Instance Returns the first ancestor of theInstancewhoseObject.ClassNameis equal to the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstAncestorWhichIsA( className: string): Instance Returns the first ancestor of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChild( name: string, recursive: boolean? = false): Instance Returns the first child of theInstancefound with the given name.Parameters Parameter Description name: stringTheInstance.Nameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstChildOfClass( className: string): Instance Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChildWhichIsA(className: string,recursive: boolean? = false,): Instance Returns the first child of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstDescendant( name: string): Instance Returns the first descendant found with the givenInstance.Name.Parameters Parameter Description name: stringTheInstance.Nameto search for.- Returns the
Actorassociated with the Instance, if any. Instance:GetAttribute( attribute: string): any Returns the value which has been assigned to the given attribute name.Parameters Parameter Description attribute: stringThe name of the attribute being retrieved.Returns Type Description anyThe value which has been assigned to the given attribute name. If no attribute has been assigned,nilis returned.Instance:GetAttributeChangedSignal( attribute: string): RBXScriptSignal Returns an event that fires when the given attribute changes.Parameters Parameter Description attribute: stringThe name of the specified attribute for which the change signal is being returned.Returns Type Description RBXScriptSignalAn event that fires when the given attribute changes.- Returns a dictionary of the instance's attributes.
Returns Type Description { [string]: any }A dictionary of string → variant pairs for each attribute where the string is the name of the attribute and the variant is a non-nil value. - Returns an array containing all of the instance's children.
Returns Type Description { Instance }An array containing the instance's children. Instance:GetDebugId( scopeLength: number? = 4): string Returns a coded string of the debug ID used internally by Roblox.Parameters Parameter Description scopeLength: number? = 4The scope length.Returns Type Description stringThe Debug ID string.- Returns an array containing all of the descendants of the instance.
Returns Type Description { Instance }An array containing the instance's descendants. - Returns a string describing the instance's ancestry.
- Returns the styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified.
Parameters Parameter Description name: stringName of the property to query.selector: string?Optional selector for the pseudo instance you are targeting on the instance.Returns Type Description anyThe styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified. Instance:GetStyledPropertyChangedSignal( property: string): RBXScriptSignal Returns an event that fires when the given style property changes on the instance.Parameters Parameter Description property: stringName of the style property for which to listen for changes.Returns Type Description RBXScriptSignalEvent that fires when the given style property changes.- Gets an array of all tags applied to the instance.
Returns Type Description { any }An array of strings, each representing a tag applied to the instance. - Check whether the instance has a given tag.
Parameters Parameter Description tag: stringThe tag to check for on the instance.Returns Type Description booleantrueif the instance has the given tag,falseotherwise. Instance:IsAncestorOf( descendant: Instance): boolean Returns true if anInstanceis an ancestor of the given descendant.Instance:IsDescendantOf( ancestor: Instance): boolean Returnstrueif anInstanceis a descendant of the given ancestor.Instance:IsPropertyModified( property: string): boolean Returnstrueif the value stored in the specified property is not equal to the code-instantiated default.Parameters Parameter Description property: stringName of the property to query.Returns Type Description booleanBoolean indicating whether the property is modified from its code‑instantiated default.Instance:QueryDescendants( selector: string): { Instance } Returns an array containing all descendants of the instance that match theselectorstring.Parameters Parameter Description selector: stringSelector string used to filter elements.Returns Type Description { Instance }An array of instances (empty if nothing matched the selector).- Removes a tag from the instance.
Parameters Parameter Description tag: stringThe tag to remove from the instance. Instance:ResetPropertyToDefault( property: string) Resets a property to its default value.Parameters Parameter Description property: stringName of the property to reset.Instance:SetAttribute( attribute: string, value: any) Sets the attribute with the given name to the given value.Instance:WaitForChild( childName: string, timeOut: number): Instance Returns the child of theInstancewith the given name. If the child does not exist, it will yield the current thread until it does.Parameters Parameter Description childName: stringTheInstance.Nameto be looked for.timeOut: numberAn optional time out parameter.- Deprecated: This item is deprecated in favor of
Instance:Destroy()andInstance:ClearAllChildren(). If you must remove an object from the game, and wish to use the object later, set itsParentproperty tonilinstead of using this method.
Sets the object'sParenttonil, and does the same for all its descendants. - Deprecated: This item has been superseded by
Instance:GetChildren()which should be used in all new work.
Returns an array of the object's children.Returns Type Description { Instance }Array of child objects/instances.Use GetChildren instead.
- Deprecated: This deprecated function is a variant of
Instance:Clone()which should be used instead.Returns Type InstanceUse Clone instead.
- Deprecated: This deprecated function is a variant of
Instance:Destroy()which should be used instead.Use Destroy instead.
Instance:findFirstChild( name: string, recursive: boolean? = false): Instance Deprecated: This deprecated function is a variant ofInstance:FindFirstChild()which should be used instead.Returns Type InstanceUse FindFirstChild instead.
- Deprecated: This deprecated function is a variant of
Instance:GetChildren()which should be used instead.Returns Type { Instance }Use GetChildren instead.
Instance:isDescendantOf( ancestor: Instance): boolean Deprecated: This deprecated function is a variant ofInstance:IsDescendantOf()which should be used instead.Parameters Parameter ancestor: InstanceReturns Type booleanUse IsDescendantOf instead.
- Deprecated: This deprecated function is a variant of
Instance:Remove()which has also been deprecated. Neither function should be used in new work.Use Remove instead.
Defined byHumanoidDescription8
- Adds the emote to the description given a name and its asset ID.
- Returns a table of an avatar's current accessories.
Parameters Parameter Description includeRigidAccessories: booleanSet to true if rigid accessories from the rigid accessory properties should also be included in the return array. False means only include layered clothing accessories from the AccessoryBlob.Returns Type Description { any }Returns an array where each entry specifies for an individual accessory the AccessoryType, AssetId, IsLayered, Order and Puffiness. HumanoidDescription:GetEmotes( ): { [string]: any } Returns a dictionary of emotes that have beenaddedorsetto this description.Returns Type Description { [string]: any }A dictionary of emotes where the key is the emote name and the value is an array of emote asset IDs. Example:
.{ Salute = {3360689775}, Agree = {4849487550}, Disagree = {4849495710} }HumanoidDescription:GetEquippedEmotes( ): { any } Returns an array of tables describing the equipped emotes that have beenset.Returns Type Description { any }An array of tables describing the name and slot which each emote is equipped. Example:
.{ {Slot = 3, Name = "Salute"}, {Slot = 2, Name = "Agree"}, {Slot = 1, Name = "Disagree"}, }HumanoidDescription:RemoveEmote( name: string) Removes any emotes that have been added under the given name.Parameters Parameter Description name: stringThe name of the emote as it wassetoradded.- Accepts a table that sets the accessories and related properties for an avatar.
Parameters Parameter Description accessories: { any }Each entry specifies for an individual accessory the AccessoryType, AssetId, IsLayered, Order and Puffiness.includeRigidAccessories: booleanSet to true if rigid accessories are also included in the passed in array (they would have to not specify Order). HumanoidDescription:SetEmotes( emotes: { [string]: any }) Sets all of the emotes on this description.Parameters Parameter Description emotes: { [string]: any }A dictionary of emotes where the key is the emote name and the value is an array of emote asset IDs. Example:
.{ Salute = {3360689775}, Agree = {4849487550}, Disagree = {4849495710} }HumanoidDescription:SetEquippedEmotes( equippedEmotes: { any }) Sets the currently equipped emotes given an array of emote names.Parameters Parameter Description equippedEmotes: { any }An array of emote names. Example:
– OR – An array of tables describing the name and slot which each emote is equipped. Example:{ "Disagree", "Agree", "Salute" }
.{ {Slot = 3, Name = "Salute"}, {Slot = 2, Name = "Agree"}, {Slot = 1, Name = "Disagree"}, }
No methods match the filters.
Events12
Object.Changed: RBXScriptSignal<( property: string)> Fires immediately after a property of the object changes, with some limitations.Parameters Parameter property: string
Instance.AncestryChanged: RBXScriptSignal<( child: Instance, parent: Instance)> Fires when theInstance.Parentproperty of this object or one of its ancestors is changed.Instance.AttributeChanged: RBXScriptSignal<( attribute: string)> Fires whenever an attribute is changed on theInstance.Parameters Parameter attribute: stringInstance.ChildAdded: RBXScriptSignal<( child: Instance)> Fires after an object is parented to thisInstance.Parameters Parameter child: InstanceInstance.ChildRemoved: RBXScriptSignal<( child: Instance)> Fires after a child is removed from thisInstance.Parameters Parameter child: InstanceInstance.DescendantAdded: RBXScriptSignal<( descendant: Instance)> Fires after a descendant is added to theInstance.Parameters Parameter descendant: InstanceInstance.DescendantRemoving: RBXScriptSignal<( descendant: Instance)> Fires immediately before a descendant of theInstanceis removed.Parameters Parameter descendant: Instance- Fires immediately before (or is deferred until after) the instance is destroyed via
Instance:Destroy(). - Fires whenever any style property is changed on the instance, including when a property is set to
nil. Instance.childAdded: RBXScriptSignal<( child: Instance)> Deprecated: This deprecated event is a variant ofInstance.ChildAddedwhich should be used instead.Parameters Parameter child: InstanceUse ChildAdded instead.
Defined byHumanoidDescription2
HumanoidDescription.EmotesChanged: RBXScriptSignal<( newEmotes: { [string]: any })> Fires when emotes are added, removed or set on this description.Parameters Parameter newEmotes: { [string]: any }HumanoidDescription.EquippedEmotesChanged: RBXScriptSignal<( newEquippedEmotes: { any })> Fires when the equipped emotes areseton this description.Parameters Parameter newEquippedEmotes: { any }
No events match the filters.