> 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/embodiment/emotion/emotion-editor.md). # Emotion editor windows Reference for the Emotion editor window, covering its four tabs and the Emotion Timeline recorder opened from the Live tab. `Convai > Emotion Editor` opens a depth-only workshop for Emotion — a wider surface than the Inspector for the same character, reached from the component inspector's **Advanced settings & expressions →** link or from the menu directly. This page documents its four tabs and the Emotion Timeline window opened from the Live tab. *** ### Open the window `Convai > Emotion Editor` (`ConvaiEmotionEditorWindow`, window title **Convai Emotions**) opens the window, already showing whichever `ConvaiEmotionController` is selected in the scene, or the first one found. The component inspector's **Advanced settings & expressions →** link opens the same window already targeting that character. Opening the window is never a required step — the Inspector carries the common setup path on its own; this window carries everything that does not fit there. The left pane lists every `ConvaiEmotionController` in the open scenes with a status dot — **Ready**, **Needs attention**, or **Not set up** — so a scene of characters can be swept without hunting through the Hierarchy. *** ### The four tabs | Tab | What it shows | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Setup** | The same setup checklist the Inspector shows, full width, plus every finding with its fix. | | **Feel** | Every setting on the assigned `ConvaiEmotionProfile`, grouped into sections — the complete surface behind the Inspector's handful of controls. | | **Expressions** | What Convai resolved on this character's own face — naming convention, match confidence, and shape counts per mesh — followed by the authored expression recipes and material effects. | | **Live** | The character's current feeling, strength, held-for duration, resting mood, mouth influence, and a bar per emotion carrying a non-zero score. Available only in Play mode. | A character with no `ConvaiEmotionProfile` assigned shows a **No personality assigned** message on **Feel** and **Expressions** instead of empty fields, since there is nothing on that character to tune yet. *** ### Emotion Timeline window The **Open Emotion Timeline** button on the **Live** tab opens `ConvaiEmotionTimelineWindow` (window title **Emotion Timeline**) already watching the character selected in the Emotion editor window. It has no menu item of its own — the timeline only makes sense once a character is already picked, which the Live tab has already done. The timeline plots a Play-mode recording of one character's emotion life over time: one line per taxonomy label's output score, the resting mood score drawn as a separate emphasized line, and vertical markers wherever `DominantEmotionChanged` or `MoodChanged` fires. Assign a target, then: | Control | What it does | | --------- | --------------------------------------------------------------------- | | **Start** | Begins recording. Only available in Play mode with a target assigned. | | **Stop** | Ends the capture without discarding it. | | **Clear** | Empties the plot. | Samples are pulled from the target's public `Current` reading at a fixed sampling interval — the recorder never touches per-frame runtime state directly. Use the timeline to tune a character's temperament by eye, or to debug a reported "the mood feels wrong" session after the fact. {% hint style="info" %} The timeline is editor-only tooling. It has no runtime API and changes nothing about how a character behaves in a build. {% endhint %} *** ### Next steps {% content-ref url="/pages/VKDUIdxDSqYZKjcrf1FW" %} [How the emotion system works](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/emotion/how-the-emotion-system-works.md) {% endcontent-ref %} {% content-ref url="/pages/PyOgkztYoFXIQ0l3uTfN" %} [Emotion quick start](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/emotion/quick-start.md) {% endcontent-ref %} --- # 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-unity-sdk/embodiment/emotion/emotion-editor.md?ask=&goal= ``` `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.