Reference API Roblox

Engine API

Website

Related

Reference API Roblox

FaceControls

The FaceControls object defines a set of properties for controlling the facial expressions of a Dynamic Head.

Member index 53

HistoryMember
731ChinRaiser: float
731ChinRaiserUpperLip: float
731Corrugator: float
731EyesLookDown: float
731EyesLookLeft: float
731EyesLookRight: float
731EyesLookUp: float
731FlatPucker: float
731Funneler: float
731JawDrop: float
731JawLeft: float
731JawRight: float
731LeftBrowLowerer: float
731LeftCheekPuff: float
731LeftCheekRaiser: float
731LeftDimpler: float
731LeftEyeClosed: float
731LeftEyeUpperLidRaiser: float
731LeftInnerBrowRaiser: float
731LeftLipCornerDown: float
731LeftLipCornerPuller: float
731LeftLipStretcher: float
731LeftLowerLipDepressor: float
731LeftNoseWrinkler: float
731LeftOuterBrowRaiser: float
731LeftUpperLipRaiser: float
731LipPresser: float
731LipsTogether: float
731LowerLipSuck: float
731MouthLeft: float
731MouthRight: float
731Pucker: float
731RightBrowLowerer: float
731RightCheekPuff: float
731RightCheekRaiser: float
731RightDimpler: float
731RightEyeClosed: float
731RightEyeUpperLidRaiser: float
731RightInnerBrowRaiser: float
731RightLipCornerDown: float
731RightLipCornerPuller: float
731RightLipStretcher: float
731RightLowerLipDepressor: float
731RightNoseWrinkler: float
731RightOuterBrowRaiser: float
731RightUpperLipRaiser: float
731TongueDown: float
731TongueOut: float
731TongueUp: float
731UpperLipSuck: float
709HasOverrideFACSData(): bool
709InternalFacsOverrideChanged()
inherited from Instance
731Archivable: bool
731Capabilities: SecurityCapabilities
731IsInSandbox: bool
731Name: string
731Parent: Instance
731PredictionMode: PredictionMode
731Sandboxed: bool
731UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
707GetDescendants(): Instances
486GetFullName(): string
706GetStyled(name: string, selector: string?): Variant
657GetStyledPropertyChangedSignal(property: string): RBXScriptSignal
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
664IsPropertyModified(property: string): bool
698QueryDescendants(selector: string): Instances
573Remove(): null
576RemoveTag(tag: string): null
664ResetPropertyToDefault(property: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
731children(): Instances
731clone(): Instance
731destroy(): null
731findFirstChild(name: string, recursive: bool = false): Instance
731getChildren(): Instances
731isDescendantOf(ancestor: Instance): bool
731remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
657StyledPropertiesChanged()
731childAdded(child: Instance)
inherited from Object
731ClassName: string
731className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
731isA(className: string): bool
647Changed(property: string)

Removed member index 1

HistoryMember
709HasInternalFacsOverrideChanged()

Description

The FaceControls object defines a set of properties for controlling the facial expressions of a character head capable of animation.

The FaceControls properties are based on the Facial Action Coding System (FACS), a comprehensive system for describing all visually discernible facial movement based on anatomy. FaceControls properties can only be set between 0 and 1. Different combinations of the FaceControls property values create different facial expressions. Recording multiple facial expressions over time creates facial animation.

What is an Animatable Head?

An animatable head is a MeshPart that implements a facial rig and is capable of playing facial animations and triggering facial expressions. A FaceControls object that is a child of a head MeshPart can change the facial expressions of the head.

A head consists of the following three components:

  • Skinned MeshPart instance for the head geometry with an internal rig that deforms this skinned MeshPart
  • FaceControls instance that drives the internal rig when properties such as FaceControls.JawDrop are changed.
  • Cage WrapTarget instance for tight fitting facial accessories

In a third-party modeling tool, such as Blender or Maya, an artist can create a joint-driven facial rig, pose the joints to match each of the individual FACS controls, and save as an FBX. When a head .FBX is imported in Studio, a facs-to-joint mapping is created. This mapping deforms the mesh geometry when FaceControls properties are changed. The mapping and the facial rig (including Bone instances) are not exposed to developers and can only be accessed through the FaceControls instance. The MeshPart for a Dynamic Head looks and behaves the same as a regular MeshPart except when a FaceControls instance is a child of the MeshPart. Editing the properties of the FaceControls deforms the MeshPart's geometry. These properties are available to animate in the Animation Editor.

See Facial animation for more information on usage and creation of an animatable head.

Animatable Heads in the Marketplace

If you are publishing your head to the Marketplace, your head asset must include a minimum subset of face controls. Roblox's publishing validation rejects assets without the following required poses:

  • EyesLookDown
  • EyesLookLeft
  • EyesLookRight
  • EyesLookUp
  • JawDrop
  • LeftEyeClosed
  • LeftLipCornerPuller
  • LeftLipStretcher
  • LeftLowerLipDepressor
  • LeftUpperLipRaiser
  • LipsTogether
  • Pucker
  • RightEyeClosed
  • RightLipCornerPuller
  • RightLipStretcher
  • RightLowerLipDepressor
  • RightUpperLipRaiser

See FACS poses reference for more information on usage and creation of an animatable head.

History 410

Members 53

ChinRaiser

TypeDefault
float0

Raises the chin up; moves the lower lip upwards

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

ChinRaiserUpperLip

TypeDefault
float0

Moves the upper lip when ChinRaiser is engaged and touching the upper lip

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

Corrugator

TypeDefault
float0

Brings the left and right brows inward together

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

EyesLookDown

TypeDefault
float0

Moves gaze down. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

EyesLookLeft

TypeDefault
float0

Moves gaze left. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

EyesLookRight

TypeDefault
float0

Moves gaze right. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

EyesLookUp

TypeDefault
float0

Moves gaze up. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

FlatPucker

TypeDefault
float0

Also known as lip tightener; brings the corners of the mouth inward and pressing the lips back against the teeth

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

Funneler

TypeDefault
float0

Makes a 'O' shape with the mouth

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

HasOverrideFACSData

Parameters (0)
No parameters.
Returns (1)
bool

History 1

InternalFacsOverrideChanged

Parameters (0)
No parameters.

History 1

JawDrop

TypeDefault
float0

Lowers the jaw downward opening the mouth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

JawLeft

TypeDefault
float0
This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

JawRight

TypeDefault
float0

Moves mouth and jaw to the right (character right)

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftBrowLowerer

TypeDefault
float0

Lowers the left brow down

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftCheekPuff

TypeDefault
float0

Puffs up the left cheek

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftCheekRaiser

TypeDefault
float0

Squints the left eye

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftDimpler

TypeDefault
float0

Moves the corners of the mouth back in Z

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftEyeClosed

TypeDefault
float0

Closes the left eyelid. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftEyeUpperLidRaiser

TypeDefault
float0

Raises the left eyelid upwards to reveal more of the eye white above the iris

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftInnerBrowRaiser

TypeDefault
float0

Raises the interior half of the left brow upwards

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftLipCornerDown

TypeDefault
float0

Lowers the corners of the mouth downwards in a frown

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftLipCornerPuller

TypeDefault
float0

Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftLipStretcher

TypeDefault
float0

Stretches the corners of the mouth apart. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftLowerLipDepressor

TypeDefault
float0

Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftNoseWrinkler

TypeDefault
float0

Raise the left nostril, pulls the brow down slightly, and wrinkles on the side of the nose

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftOuterBrowRaiser

TypeDefault
float0

Raises the outer part of the left brow upwards

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LeftUpperLipRaiser

TypeDefault
float0

Raises the left upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LipPresser

TypeDefault
float0

Presses the lips together

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LipsTogether

TypeDefault
float0

Brings the lips together relative to JawDrop. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

LowerLipSuck

TypeDefault
float0

Rolls the lower lip up over the teeth

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

MouthLeft

TypeDefault
float0

Moves the mouth left

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

MouthRight

TypeDefault
float0

Moves the mouth right

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

Pucker

TypeDefault
float0

Makes a kiss-like shape with the mouth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

  • 731 Change Default of Pucker from to 0
  • 726 Change Default of Pucker from 0 to
  • 553 Change Default of Pucker from to 0
  • 490 Change WriteSecurity of Pucker from None to PluginSecurity
  • 490 Change Tags of Pucker from [NotReplicated, NotScriptable] to [NotReplicated]
  • 490 Change ReadSecurity of Pucker from None to PluginSecurity
  • 489 Change Category of Pucker from Control to Mouth
  • 487 Add Pucker
Tags: [NotReplicated]

RightBrowLowerer

TypeDefault
float0

Lowers the right brow down

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightCheekPuff

TypeDefault
float0

Puffs up the right cheek

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightCheekRaiser

TypeDefault
float0

Squints the right eye

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightDimpler

TypeDefault
float0

Moves the corners of the mouth back in Z

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightEyeClosed

TypeDefault
float0

Closes the right eyelid. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightEyeUpperLidRaiser

TypeDefault
float0

Raises the right eyelid upwards to reveal more of the eye white above the iris

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightInnerBrowRaiser

TypeDefault
float0

Raises the interior half of the right brow upwards

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightLipCornerDown

TypeDefault
float0

Lowers the corners of the mouth downwards in a frown

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightLipCornerPuller

TypeDefault
float0

Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightLipStretcher

TypeDefault
float0

Stretches the corners of the mouth apart. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightLowerLipDepressor

TypeDefault
float0

Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightNoseWrinkler

TypeDefault
float0

Raises the right nostril, pulls the brow down slightly, and wrinkles on the side of the nose

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightOuterBrowRaiser

TypeDefault
float0

Raises the outer part of the right brow upwards

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

RightUpperLipRaiser

TypeDefault
float0

Raises the right upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

TongueDown

TypeDefault
float0

Bends the tongue down

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

TongueOut

TypeDefault
float0

Extends the tip of the tongue out of the mouth

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

TongueUp

TypeDefault
float0

Bends the tongue up

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

UpperLipSuck

TypeDefault
float0

Rolls the upper lip around the teeth

This property is not replicated. Its interface does not cross the network boundary.

History 8

Tags: [NotReplicated]

Removed members 1

HasInternalFacsOverrideChanged

Parameters (0)
No parameters.

History 2

Settings