Emotion

Find guides for adding emotionally responsive facial animation to Convai characters — from quick setup to scripting API and troubleshooting.

The Emotion system translates Convai AI emotional signals into live facial animation, driving blendshapes, Animator parameters, or both simultaneously. This section covers everything from a first working setup to custom taxonomy authoring and the complete scripting API.

How the emotion system works Understand the pipeline, key concepts, and required component placement.

Emotion quick start Attach the Emotion Controller, assign the bundled profile, and see your NPC react emotionally to conversation — no custom assets required.

Emotion profile Configure smoothing speed, micro-expression bursts, neutral alternation, and output bindings in one portable asset.

Emotion output bindings Map smoothed emotion scores to facial blendshapes and Animator float parameters, with per-slot weight and LipSync control.

Emotion taxonomy Understand the built-in Plutchik vocabulary, how server aliases are resolved, and how to author a custom taxonomy.

Emotion scripting API Read live emotion state, inject overrides, lock expressions, and react to emotion events — from Inspector relays to typed C# subscriptions.

Emotion examples Complete scenarios covering hazard triggers, locked greetings, distress branching, analytics logging, and Editor debugging.

Troubleshoot emotion Step-by-step fixes for the most common problems — from expressions that will not move to LipSync conflicts and production build issues.

Next steps

Start with Emotion quick start to get expressions running on your first NPC. Then read How the emotion system works to understand the pipeline and component roles before moving into configuration and reference pages.