FaceControls

Show Deprecated

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 a 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 pose reference for more information on usage and creation of a animatable head.

Summary

Properties

  • not replicated
    read parallel

    Raises the chin up; moves the lower lip upwards.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Brings the left and right brows inward together.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Makes a 'O' shape with the mouth.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Moves mouth and jaw to the left (character left).

  • not replicated
    read parallel

    Moves mouth and jaw to the right (character right).

  • not replicated
    read parallel

    Lowers the left brow down.

  • not replicated
    read parallel

    Puffs up the left cheek.

  • not replicated
    read parallel

    Squints the left eye.

  • not replicated
    read parallel

    Moves the corners of the mouth back in Z.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Raises the interior half of the left brow upwards.

  • not replicated
    read parallel

    Lowers the corners of the mouth downwards in a frown.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Raises the outer part of the left brow upwards.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Presses the lips together.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Rolls the lower lip up over the teeth.

  • not replicated
    read parallel

    Moves the mouth left.

  • not replicated
    read parallel

    Moves the mouth right.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Lowers the right brow down.

  • not replicated
    read parallel

    Puffs up the right cheek.

  • not replicated
    read parallel

    Squints the right eye.

  • not replicated
    read parallel

    Moves the corners of the mouth back in Z.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Raises the interior half of the right brow upwards.

  • not replicated
    read parallel

    Lowers the corners of the mouth downwards in a frown.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Raises the outer part of the right brow upwards.

  • not replicated
    read parallel

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

  • not replicated
    read parallel

    Bends the tongue down.

  • not replicated
    read parallel

    Extends the tip of the tongue out of the mouth.

  • not replicated
    read parallel

    Bends the tongue up.

  • not replicated
    read parallel

    Rolls the upper lip around the teeth.

Properties

ChinRaiser

not replicated
read parallel

Raises the chin up; moves the lower lip upwards

ChinRaiserUpperLip

not replicated
read parallel

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

Corrugator

not replicated
read parallel

Brings the left and right brows inward together

EyesLookDown

not replicated
read parallel

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

EyesLookLeft

not replicated
read parallel

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

EyesLookRight

not replicated
read parallel

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

EyesLookUp

not replicated
read parallel

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

FlatPucker

not replicated
read parallel

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

Funneler

not replicated
read parallel

Makes a 'O' shape with the mouth

JawDrop

not replicated
read parallel

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

JawLeft

not replicated
read parallel

JawRight

not replicated
read parallel

Moves mouth and jaw to the right (character right)

LeftBrowLowerer

not replicated
read parallel

Lowers the left brow down

LeftCheekPuff

not replicated
read parallel

Puffs up the left cheek

LeftCheekRaiser

not replicated
read parallel

Squints the left eye

LeftDimpler

not replicated
read parallel

Moves the corners of the mouth back in Z

LeftEyeClosed

not replicated
read parallel

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

LeftEyeUpperLidRaiser

not replicated
read parallel

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

LeftInnerBrowRaiser

not replicated
read parallel

Raises the interior half of the left brow upwards

LeftLipCornerDown

not replicated
read parallel

Lowers the corners of the mouth downwards in a frown

LeftLipCornerPuller

not replicated
read parallel

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

LeftLipStretcher

not replicated
read parallel

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

LeftLowerLipDepressor

not replicated
read parallel

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

LeftNoseWrinkler

not replicated
read parallel

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

LeftOuterBrowRaiser

not replicated
read parallel

Raises the outer part of the left brow upwards

LeftUpperLipRaiser

not replicated
read parallel

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

LipPresser

not replicated
read parallel

Presses the lips together

LipsTogether

not replicated
read parallel

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

LowerLipSuck

not replicated
read parallel

Rolls the lower lip up over the teeth

MouthLeft

not replicated
read parallel

Moves the mouth left

MouthRight

not replicated
read parallel

Moves the mouth right

Pucker

not replicated
read parallel

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

RightBrowLowerer

not replicated
read parallel

Lowers the right brow down

RightCheekPuff

not replicated
read parallel

Puffs up the right cheek

RightCheekRaiser

not replicated
read parallel

Squints the right eye

RightDimpler

not replicated
read parallel

Moves the corners of the mouth back in Z

RightEyeClosed

not replicated
read parallel

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

RightEyeUpperLidRaiser

not replicated
read parallel

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

RightInnerBrowRaiser

not replicated
read parallel

Raises the interior half of the right brow upwards

RightLipCornerDown

not replicated
read parallel

Lowers the corners of the mouth downwards in a frown

RightLipCornerPuller

not replicated
read parallel

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

RightLipStretcher

not replicated
read parallel

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

RightLowerLipDepressor

not replicated
read parallel

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

RightNoseWrinkler

not replicated
read parallel

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

RightOuterBrowRaiser

not replicated
read parallel

Raises the outer part of the right brow upwards

RightUpperLipRaiser

not replicated
read parallel

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

TongueDown

not replicated
read parallel

Bends the tongue down

TongueOut

not replicated
read parallel

Extends the tip of the tongue out of the mouth

TongueUp

not replicated
read parallel

Bends the tongue up

UpperLipSuck

not replicated
read parallel

Rolls the upper lip around the teeth

Methods

Events