> 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/character-actions.md).

# Character actions

Character actions let a Convai character respond to what a player says with an in-scene behavior — walking to a target, making eye contact, playing a gesture, or running your own gameplay code. Convai identifies which action to run and what to target; the Actions Editor is where you add and configure the 21 built-in executors that carry it out, or wire in your own. This section covers everything from your first action to the full scripting API.

Several built-in executors run through the Gaze and Body Animation embodiment modules, so a character needs the matching module installed before those actions work — see [Embodiment](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment.md).

<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 character actions work</strong><br>Understand the pipeline, key concepts, required components, and built-in executors.</td><td><a href="/pages/mqkxc4D6OCQA9OVVDCLv">/pages/mqkxc4D6OCQA9OVVDCLv</a></td></tr><tr><td><strong>Character actions quick start</strong><br>Add a ready-made action to your NPC from the Actions Editor's starter catalog — no scripting required.</td><td><a href="/pages/M9Lh8OZ24Oqv9SmxMjzb">/pages/M9Lh8OZ24Oqv9SmxMjzb</a></td></tr><tr><td><strong>Actions Editor</strong><br>Reference for the Actions Editor window: the Add Action catalog, and one-click executor provisioning.</td><td><a href="/pages/h7pI1nHXiQuo1IpqPfiK">/pages/h7pI1nHXiQuo1IpqPfiK</a></td></tr><tr><td><strong>Configure character actions</strong><br>Full reference for <code>ConvaiActionConfigSource</code> — action definitions, targets, and connect-time overrides.</td><td><a href="/pages/u3JAohXiqBNMG6zZ5m60">/pages/u3JAohXiqBNMG6zZ5m60</a></td></tr><tr><td><strong>Update character actions at runtime</strong><br>Apply <code>ConvaiActionConfigPatch</code> updates to actions, objects, characters, and attention while a session is active, confirmed by Convai's acknowledgment.</td><td><a href="/pages/KujMCkE0oVyqYjXPi4UQ">/pages/KujMCkE0oVyqYjXPi4UQ</a></td></tr><tr><td><strong>Action executors</strong><br>Reference for all 21 executor components with Inspector field tables.</td><td><a href="/pages/6RYF3LHemCYzxRfZpueZ">/pages/6RYF3LHemCYzxRfZpueZ</a></td></tr><tr><td><strong>Dispatcher and batch policies</strong><br>Configure how <code>ConvaiActionDispatcher</code> handles concurrent batches and step failures.</td><td><a href="/pages/L2RNE4SlLqEb39SpjbDU">/pages/L2RNE4SlLqEb39SpjbDU</a></td></tr><tr><td><strong>Write a custom action executor</strong><br>Implement <code>IConvaiActionExecutor</code> to create project-specific behaviors for any action.</td><td><a href="/pages/yKmOPjUYIRCR4eqPYD0A">/pages/yKmOPjUYIRCR4eqPYD0A</a></td></tr><tr><td><strong>How action target resolution works</strong><br>How a command's target words are matched to real objects in your scene, and how attention narrows the match.</td><td><a href="/pages/RKSqmXPbQonS4iJeIfiO">/pages/RKSqmXPbQonS4iJeIfiO</a></td></tr><tr><td><strong>Character actions scripting reference</strong><br>Complete public API for all action system types, events, enums, and components.</td><td><a href="/pages/73HufYIPX0JRnnAsGDbk">/pages/73HufYIPX0JRnnAsGDbk</a></td></tr><tr><td><strong>Character actions examples</strong><br>Five progressive scenarios from no-code Inspector setup to scripted batch injection and speech-synced timing.</td><td><a href="/pages/f7muso7lrEOfJU9hnYeK">/pages/f7muso7lrEOfJU9hnYeK</a></td></tr><tr><td><strong>Migrate actions to v4.5.0</strong><br>Update a pre-4.5.0 project for the reorganized executor library, including the renamed <code>ConvaiUnityEventActionExecutor</code> GUID change.</td><td><a href="/pages/rTbWyUbsgiZjTet57XYF">/pages/rTbWyUbsgiZjTet57XYF</a></td></tr><tr><td><strong>Troubleshoot character actions</strong><br>Diagnose action pipeline issues with the Action Troubleshooter and a symptom/cause/fix reference.</td><td><a href="/pages/LZcDaILUbaCK85OVcPJ6">/pages/LZcDaILUbaCK85OVcPJ6</a></td></tr></tbody></table>


---

# 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/features/character-actions.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.