> 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. `ConvaiActionDispatcher` can gate the first action in a batch until the character starts speaking, when the action opts in with `WaitForBotSpeech`. Runtime updates to actions, objects, characters, and attention take effect only after Convai confirms them. This section covers everything from a first working setup to the complete scripting API.


How character actions work Understand the pipeline, key concepts, required components, and built-in executors.	/pages/mqkxc4D6OCQA9OVVDCLv
Character actions quick start Add a working Move To action to your NPC — no scripting required.	/pages/M9Lh8OZ24Oqv9SmxMjzb
Configure character actions Full reference for `ConvaiActionConfigSource` — action definitions, targets, and connect-time overrides.	/pages/u3JAohXiqBNMG6zZ5m60
Update character actions at runtime Apply `ConvaiActionConfigPatch` updates to actions, objects, characters, and attention while a session is active, confirmed by the backend ACK.	/pages/KujMCkE0oVyqYjXPi4UQ
Action executors Reference for all seven executor components with Inspector field tables.	/pages/6RYF3LHemCYzxRfZpueZ
Dispatcher and batch policies Configure how `ConvaiActionDispatcher` handles concurrent batches and step failures.	/pages/L2RNE4SlLqEb39SpjbDU
Write a custom action executor Implement `IConvaiActionExecutor` to create project-specific behaviors for any action.	/pages/yKmOPjUYIRCR4eqPYD0A
Attention and reference grounding Keep Convai's target resolution aligned with what the player is focused on at runtime.	/pages/RKSqmXPbQonS4iJeIfiO
Character actions scripting reference Complete public API for all action system types, events, enums, and components.	/pages/73HufYIPX0JRnnAsGDbk
Character actions examples Five progressive scenarios from no-code Inspector setup to scripted batch injection and speech-synced timing.	/pages/f7muso7lrEOfJU9hnYeK
Troubleshoot character actions Diagnose action pipeline issues with `ConvaiActionDebugProbe` and a symptom/cause/fix reference.	/pages/LZcDaILUbaCK85OVcPJ6

--- # 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=&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.