> 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-unity-sdk/features/emotion.md).

# Emotion

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.

<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 the pipeline, key concepts, and required component placement.</td><td><a href="/pages/VKDUIdxDSqYZKjcrf1FW">/pages/VKDUIdxDSqYZKjcrf1FW</a></td></tr><tr><td><strong>Emotion quick start</strong><br>Attach the Emotion Controller, assign the bundled profile, and see your NPC react emotionally to conversation — no custom assets required.</td><td><a href="/pages/PyOgkztYoFXIQ0l3uTfN">/pages/PyOgkztYoFXIQ0l3uTfN</a></td></tr><tr><td><strong>Emotion profile</strong><br>Configure smoothing speed, micro-expression bursts, neutral alternation, and output bindings in one portable asset.</td><td><a href="/pages/4kPK7vkbjtuDa9qfc75O">/pages/4kPK7vkbjtuDa9qfc75O</a></td></tr><tr><td><strong>Emotion output bindings</strong><br>Map smoothed emotion scores to facial blendshapes and Animator float parameters, with per-slot weight and LipSync control.</td><td><a href="/pages/mqwNGzveKocvvR9sOhts">/pages/mqwNGzveKocvvR9sOhts</a></td></tr><tr><td><strong>Emotion taxonomy</strong><br>Understand the built-in Plutchik vocabulary, how server aliases are resolved, and how to author a custom taxonomy.</td><td><a href="/pages/FOiJ57aQtQ6qN404z3rE">/pages/FOiJ57aQtQ6qN404z3rE</a></td></tr><tr><td><strong>Emotion scripting API</strong><br>Read live emotion state, inject overrides, lock expressions, and react to emotion events — from Inspector relays to typed C# subscriptions.</td><td><a href="/pages/OM0Nzbb46ldsnhmYvu6a">/pages/OM0Nzbb46ldsnhmYvu6a</a></td></tr><tr><td><strong>Emotion examples</strong><br>Complete scenarios covering hazard triggers, locked greetings, distress branching, analytics logging, and Editor debugging.</td><td><a href="/pages/5Bo6oC1qF0jfrzgrtD56">/pages/5Bo6oC1qF0jfrzgrtD56</a></td></tr><tr><td><strong>Troubleshoot emotion</strong><br>Step-by-step fixes for the most common problems — from expressions that will not move to LipSync conflicts and production build issues.</td><td><a href="/pages/N6zov1sJHXMKI44gRL56">/pages/N6zov1sJHXMKI44gRL56</a></td></tr></tbody></table>

### Next steps

Start with [Emotion quick start](/api-docs/plugins-and-integrations/convai-unity-sdk/features/emotion/quick-start.md) to get expressions running on your first NPC. Then read [How the emotion system works](/api-docs/plugins-and-integrations/convai-unity-sdk/features/emotion/how-the-emotion-system-works.md) to understand the pipeline and component roles before moving into configuration and reference pages.


---

# 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:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/convai-unity-sdk/features/emotion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.