Emotion

Find guides for animating AI character expressions in sync with conversation — from quick Blueprint setup to full reference and troubleshooting.

The emotion system lets a Convai character express feelings through facial animation as it converses. Convai analyzes the character's generated speech and delivers an emotion state alongside the audio. The plugin exposes that state as per-emotion float scores you can read in Blueprint with Get Emotion Score and apply to morph targets or Animation Blueprint variables in any way that suits your project.

How the emotion system works Understand how Convai delivers emotion state, how server scale maps to scores, and what the offset and lock controls do.

Emotion quick start Subscribe to emotion state changes and apply per-emotion scores to morph targets on a character mesh in a few Blueprint steps.

Emotion Blueprint reference The supported score-driven emotion properties, functions, and state-changed event on the Convai Chatbot component.

Emotion examples Force an emotion, lock expression state, and read scores to drive gameplay effects or visual feedback.

Troubleshoot emotion Fix emotions not appearing, a state stuck in locked mode, and morph target mismatches on the character mesh.

Start here

Start with How the emotion system works to understand the scoring model and controls. Then follow Emotion quick start to wire expression scores to a character mesh in a few Blueprint steps before moving into reference and advanced examples.