HumanoidDescription
HumanoidDescription : Instance
Overview
The HumanoidDescription class is designed to provide a flexible way to define and configure the appearance and animations of humanoid models, allowing developers to dynamically change these aspects at runtime.
Description
The HumanoidDescription class manages character customization and animation data. It is responsible for organizing properties that define the humanoidβs appearance, such as accessories, body colors, and clothing items, alongside animation preferences. With methods to add or remove emotes, get or set accessories, and handle animation configurations, it allows for dynamic updates that enhance user interaction and character personalization in games.
Properties
AccessoryBlob
string
This property manages the serialized data of all attached accessories in a single string format.
Code Samples
BackAccessory
string
Defines the ID of an accessory applied to the back of the humanoid.
Code Samples
FaceAccessory
string
Specifies the ID of an accessory used on the humanoidβs face.
Code Samples
FrontAccessory
string
Determines the ID of an accessory equipped at the front side of the humanoid.
Code Samples
HairAccessory
string
Holds the ID of the hair accessory applied to the humanoid.
Code Samples
HatAccessory
string
Defines the ID of a hat accessory worn by the humanoid.
Code Samples
NeckAccessory
string
Specifies the ID of an accessory mounted on the neck of the humanoid.
Code Samples
ShoulderAccessory
string
Indicates the ID of an accessory attached to the humanoidβs shoulders.
Code Samples
WaistAccessory
string
Represents the ID of an accessory positioned at the humanoidβs waist.
Code Samples
ClimbAnimation
number
Holds the asset ID for the humanoidβs climb animation.
Code Samples
FallAnimation
number
Stores the asset ID for the humanoidβs fall animation.
Code Samples
IdleAnimation
number
Defines the asset ID for the humanoidβs idle animation.
Code Samples
JumpAnimation
number
Contains the asset ID for the humanoidβs jump animation.
Code Samples
MoodAnimation
number
Manages the asset ID related to mood-based animations for humanoids.
Code Samples
RunAnimation
number
Specifies the asset ID for the humanoidβs running animation.
Code Samples
SwimAnimation
number
Represents the asset ID for the humanoidβs swimming animation.
Code Samples
WalkAnimation
number
Holds the asset ID for the humanoidβs walking animation.
Code Samples
HeadColor
Color3
Sets or gets the color of the humanoidβs head.
Code Samples
LeftArmColor
Color3
Defines the color of the humanoidβs left arm.
Code Samples
LeftLegColor
Color3
Specifies the color of the humanoidβs left leg.
Code Samples
RightArmColor
Color3
Manages the color of the humanoidβs right arm.
Code Samples
RightLegColor
Color3
Controls the color of the humanoidβs right leg.
Code Samples
TorsoColor
Color3
Manages the color of the humanoidβs torso.
Code Samples
Face
number
Holds the asset ID of the humanoidβs face design.
Code Samples
Head
number
Represents the asset ID for the humanoidβs head design.
Code Samples
LeftArm
number
Contains the asset ID for the humanoidβs left arm.
Code Samples
LeftLeg
number
Holds the asset ID for the humanoidβs left leg.
Code Samples
RightArm
number
Specifies the asset ID for the humanoidβs right arm.
Code Samples
RightLeg
number
Stores the asset ID for the humanoidβs right leg.
Code Samples
Torso
number
Defines the asset ID for the humanoidβs torso.
Code Samples
GraphicTShirt
number
Represents the asset ID for the humanoidβs graphic T-shirt.
Code Samples
Pants
number
Specifies the asset ID for the humanoidβs pants.
Code Samples
Shirt
number
Holds the asset ID for the humanoidβs shirt.
Code Samples
BodyTypeScale
number
Controls the scaling factor of the humanoidβs body type.
Code Samples
DepthScale
number
Manages the scaling factor for the depth of the humanoidβs body.
Code Samples
HeadScale
number
Adjusts the scaling factor for the humanoidβs head size.
Code Samples
HeightScale
number
Determines the scaling factor for the humanoidβs height.
Code Samples
ProportionScale
number
Manages the proportion scaling for the humanoidβs body.
Code Samples
WidthScale
number
Controls the width scaling factor for the humanoid.
Code Samples
Methods
AddEmote
Adds a custom emote to the humanoid description, associating a name with a corresponding animation asset ID.
Parameters
string
InName
Name of the emote
number
InAssetId
Asset ID of the animation
Return
void
Code Samples
GetAccessories
Retrieves all accessories assigned to the humanoid, with an option to include rigid accessories.
Parameters
bool
InIncludeRigidAccessories
Whether to include rigid accessories in the result
Return
Tuple
Code Samples
GetEmotes
Retrieves the list of all emotes available for the humanoid.
Parameters
Return
Value
Code Samples
GetEquippedEmotes
Gets the emotes currently equipped for the humanoid.
Parameters
Return
Tuple
Code Samples
RemoveEmote
Removes an emote from the humanoid description by emote name.
Parameters
string
InName
Name of the emote to remove
Return
void
Code Samples
SetAccessories
Replaces the humanoidβs accessories with a new set, with an option to include rigid accessories.
Parameters
array
InAccessories
An array of new accessories
bool
InIncludeRigidAccessories
Whether to replace rigid accessories
Return
void
Code Samples
SetEmotes
{Description Slot}
Parameters
Value
InEmotes
Return
void
Code Samples
SetEquippedEmotes
{Description Slot}
Parameters
array
InEquippedEmotes
Return
void
Code Samples
Events
EmotesChanged
{Description Slot}
Parameters
Code Samples
EquippedEmotesChanged
{Description Slot}