Emotion

Find guides for a Convai character's facial expression and mood, from first setup through the scripting API and troubleshooting.

Emotion drives a Convai character's facial expression and its longer-lived resting mood. Part of its input arrives with Convai's response; the rest is yours to configure and script. This section covers everything from a first working setup to mood control, taxonomy authoring, and the complete scripting API.

How the emotion system works Understand the pipeline, where its input comes from, and how expression reaches the face.

Emotion quick start Attach the Emotion Controller, run setup, and see your character react emotionally to conversation.

Moods Set and clear a character's resting mood from code, and see how a mood differs from a momentary emotion.

Emotion profile Configure smoothing, blending, micro-expression life, and mood in one portable asset.

Emotion output bindings Learn how composed emotion scores reach the character's face and shader properties.

Emotion taxonomy Understand the built-in Plutchik vocabulary and how to author a custom one.

Emotion scripting API Read live emotion state, control mood, and react to emotion events from code.

Emotion editor windows Use the Emotion editor window's four tabs and the Emotion Timeline recorder.

Emotion examples Complete scenarios covering triggers, locked expressions, and mood-driven behavior.

Troubleshoot emotion Step-by-step fixes for expressions that will not move and other common problems.

Next steps

Start with Emotion quick start to get expressions running on your first character. Then read How the emotion system works to understand the pipeline and where its input comes from before moving into mood control and reference pages.