> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/emotion.md).

# Emotion

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.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How the emotion system works</strong><br>Understand how Convai delivers emotion state, how server scale maps to scores, and what the offset and lock controls do.</td><td><a href="/pages/rhrJSUDsxJtlVoC5RBxt">/pages/rhrJSUDsxJtlVoC5RBxt</a></td></tr><tr><td><strong>Emotion quick start</strong><br>Subscribe to emotion state changes and apply per-emotion scores to morph targets on a character mesh in a few Blueprint steps.</td><td><a href="/pages/DdElnRB3Nhl5aVIsBAlu">/pages/DdElnRB3Nhl5aVIsBAlu</a></td></tr><tr><td><strong>Emotion Blueprint reference</strong><br>The supported score-driven emotion properties, functions, and state-changed event on the Convai Chatbot component.</td><td><a href="/pages/49dLglYXwdqtxoT5OviR">/pages/49dLglYXwdqtxoT5OviR</a></td></tr><tr><td><strong>Emotion examples</strong><br>Force an emotion, lock expression state, and read scores to drive gameplay effects or visual feedback.</td><td><a href="/pages/b9ztYs8XT0CsQtGnPjeC">/pages/b9ztYs8XT0CsQtGnPjeC</a></td></tr><tr><td><strong>Troubleshoot emotion</strong><br>Fix emotions not appearing, a state stuck in locked mode, and morph target mismatches on the character mesh.</td><td><a href="/pages/tBJKhFf61Mm1mKyjfr69">/pages/tBJKhFf61Mm1mKyjfr69</a></td></tr></tbody></table>

### Start here

Start with [How the emotion system works](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/emotion/how-the-emotion-system-works.md) to understand the scoring model and controls. Then follow [Emotion quick start](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/emotion/emotion-quick-start.md) to wire expression scores to a character mesh in a few Blueprint steps before moving into reference and advanced examples.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/emotion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.