Facial Expressions system - Protected/BetterBennett GitHub Wiki

This system determines which facial expression is displayed on the avatar at any given time, excluding visemes. At time of writing, the avatar has 28 possible facial expressions. Each facial expression consists of:

An animation that drives mouth and eyebrow blendshapes, as well as some special additional blendshapes, in order to pose the face;
A tracking controller behavior that moves eye tracking in our out of animation mode, depending on the facial expression;
An icon that represents the facial expression in the HUD. There are only 15 possible icons, so multiple facial expressions can be represented by the same icon. The icon may flicker in the HUD while facial expressions are being changed due to how Unity animators interpolate states.

The facial expression controller determines which facial expression to display based on three priority layers:

Face from Base: The facial expression set in the Base face menu is displayed by default.
Face from Action: An ongoing Action, AFK animation, Interaction or Immersive gesture can override the base facial expression for a brief period of time or for the duration of the event.
Face from Gesture: If Face gestures are enabled, you can use gestures to override Base or Action faces.

Face gestures

Use Left RockNRoll to enable face gestures and select your desired facial expression using your right hand gesture:

Right HandOpen: Thoughtful
Right Point: Suspicious
Right Victory: Worried
Right RockNRoll: Wondrous
Right Fingergun: Smirk
Right ThumbsUp: Anime smile