> 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 enable NPC characters to respond to player requests with physical in-scene behaviors — navigation, object interaction, animations, and custom gameplay logic. This section covers everything from a first working setup to 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 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 working Move To action to your NPC — no scripting required.</td><td><a href="/pages/M9Lh8OZ24Oqv9SmxMjzb">/pages/M9Lh8OZ24Oqv9SmxMjzb</a></td></tr><tr><td><strong>Configure character actions</strong><br>Full reference for ConvaiActionConfigSource — action definitions, targets, and connect-time overrides.</td><td><a href="/pages/u3JAohXiqBNMG6zZ5m60">/pages/u3JAohXiqBNMG6zZ5m60</a></td></tr><tr><td><strong>Action executors</strong><br>Reference for all six 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 ConvaiActionDispatcher 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 IConvaiActionExecutor to create project-specific behaviors for any action.</td><td><a href="/pages/yKmOPjUYIRCR4eqPYD0A">/pages/yKmOPjUYIRCR4eqPYD0A</a></td></tr><tr><td><strong>Attention and reference grounding</strong><br>Keep Convai's target resolution aligned with what the player is focused on at runtime.</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>Four progressive scenarios from no-code Inspector setup to scripted batch injection.</td><td><a href="/pages/f7muso7lrEOfJU9hnYeK">/pages/f7muso7lrEOfJU9hnYeK</a></td></tr><tr><td><strong>Troubleshoot character actions</strong><br>Diagnose action pipeline issues with ConvaiActionDebugProbe 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:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/convai-unity-sdk/features/character-actions.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.