# FaceControls

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Memory category: Animation
- HTML page: https://rapi.sleaze.dev/classes/FaceControls/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/FaceControls

The [`FaceControls`](https://rapi.sleaze.dev/classes/FaceControls.md) object defines a set of properties for controlling the facial expressions of a Dynamic Head.

## Properties

### Corrugator

```luau
FaceControls.Corrugator: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Brings the left and right brows inward together.

### LeftBrowLowerer

```luau
FaceControls.LeftBrowLowerer: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Lowers the left brow down.

### LeftInnerBrowRaiser

```luau
FaceControls.LeftInnerBrowRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Raises the interior half of the left brow upwards.

### LeftNoseWrinkler

```luau
FaceControls.LeftNoseWrinkler: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftOuterBrowRaiser

```luau
FaceControls.LeftOuterBrowRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Raises the outer part of the left brow upwards.

### RightBrowLowerer

```luau
FaceControls.RightBrowLowerer: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Lowers the right brow down.

### RightInnerBrowRaiser

```luau
FaceControls.RightInnerBrowRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Raises the interior half of the right brow upwards.

### RightNoseWrinkler

```luau
FaceControls.RightNoseWrinkler: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightOuterBrowRaiser

```luau
FaceControls.RightOuterBrowRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Raises the outer part of the right brow upwards.

### InternalOverrideFACSData

```luau
FaceControls.InternalOverrideFACSData: string = ""
```

- Tags: Hidden, Not scriptable, Roblox engine security, Read capabilities: Animation

### EyesLookDown

```luau
FaceControls.EyesLookDown: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### EyesLookLeft

```luau
FaceControls.EyesLookLeft: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### EyesLookRight

```luau
FaceControls.EyesLookRight: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### EyesLookUp

```luau
FaceControls.EyesLookUp: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftCheekRaiser

```luau
FaceControls.LeftCheekRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Squints the left eye.

### LeftEyeClosed

```luau
FaceControls.LeftEyeClosed: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftEyeUpperLidRaiser

```luau
FaceControls.LeftEyeUpperLidRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightCheekRaiser

```luau
FaceControls.RightCheekRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Squints the right eye.

### RightEyeClosed

```luau
FaceControls.RightEyeClosed: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightEyeUpperLidRaiser

```luau
FaceControls.RightEyeUpperLidRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### JawDrop

```luau
FaceControls.JawDrop: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### JawLeft

```luau
FaceControls.JawLeft: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### JawRight

```luau
FaceControls.JawRight: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### ChinRaiser

```luau
FaceControls.ChinRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Raises the chin up; moves the lower lip upwards.

### ChinRaiserUpperLip

```luau
FaceControls.ChinRaiserUpperLip: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### FlatPucker

```luau
FaceControls.FlatPucker: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### Funneler

```luau
FaceControls.Funneler: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Makes a 'O' shape with the mouth.

### LeftCheekPuff

```luau
FaceControls.LeftCheekPuff: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Puffs up the left cheek.

### LeftDimpler

```luau
FaceControls.LeftDimpler: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Moves the corners of the mouth back in Z.

### LeftLipCornerDown

```luau
FaceControls.LeftLipCornerDown: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Lowers the corners of the mouth downwards in a frown.

### LeftLipCornerPuller

```luau
FaceControls.LeftLipCornerPuller: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftLipStretcher

```luau
FaceControls.LeftLipStretcher: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftLowerLipDepressor

```luau
FaceControls.LeftLowerLipDepressor: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LeftUpperLipRaiser

```luau
FaceControls.LeftUpperLipRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LipPresser

```luau
FaceControls.LipPresser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Presses the lips together.

### LipsTogether

```luau
FaceControls.LipsTogether: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### LowerLipSuck

```luau
FaceControls.LowerLipSuck: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Rolls the lower lip up over the teeth.

### MouthLeft

```luau
FaceControls.MouthLeft: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Moves the mouth left.

### MouthRight

```luau
FaceControls.MouthRight: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Moves the mouth right.

### Pucker

```luau
FaceControls.Pucker: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightCheekPuff

```luau
FaceControls.RightCheekPuff: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Puffs up the right cheek.

### RightDimpler

```luau
FaceControls.RightDimpler: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Moves the corners of the mouth back in Z.

### RightLipCornerDown

```luau
FaceControls.RightLipCornerDown: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Lowers the corners of the mouth downwards in a frown.

### RightLipCornerPuller

```luau
FaceControls.RightLipCornerPuller: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightLipStretcher

```luau
FaceControls.RightLipStretcher: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightLowerLipDepressor

```luau
FaceControls.RightLowerLipDepressor: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### RightUpperLipRaiser

```luau
FaceControls.RightUpperLipRaiser: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

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

### UpperLipSuck

```luau
FaceControls.UpperLipSuck: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Rolls the upper lip around the teeth.

### TongueDown

```luau
FaceControls.TongueDown: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Bends the tongue down.

### TongueOut

```luau
FaceControls.TongueOut: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Extends the tip of the tongue out of the mouth.

### TongueUp

```luau
FaceControls.TongueUp: number = 0
```

- Tags: Not replicated, Read capabilities: Animation

Bends the tongue up.

## Methods

### HasOverrideFACSData

```luau
FaceControls:HasOverrideFACSData(): boolean
```

- Tags: Roblox script security, Capabilities: Animation

## Events

### InternalFacsOverrideChanged

```luau
FaceControls.InternalFacsOverrideChanged: RBXScriptSignal<()>
```

- Tags: Roblox script security, Capabilities: Animation

## Inherited members

- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`
