Character actions

Find quick-start guides, executor references, dispatcher configuration, scripting API, and usage examples for the Convai character actions system.

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.

How character actions work Understand the pipeline, key concepts, required components, and built-in executors.

Character actions quick start Add a working Move To action to your NPC — no scripting required.

Configure character actions Full reference for ConvaiActionConfigSource — action definitions, targets, and connect-time overrides.

Action executors Reference for all six executor components with Inspector field tables.

Dispatcher and batch policies Configure how ConvaiActionDispatcher handles concurrent batches and step failures.

Write a custom action executor Implement IConvaiActionExecutor to create project-specific behaviors for any action.

Attention and reference grounding Keep Convai's target resolution aligned with what the player is focused on at runtime.

Character actions scripting reference Complete public API for all action system types, events, enums, and components.

Character actions examples Four progressive scenarios from no-code Inspector setup to scripted batch injection.

Troubleshoot character actions Diagnose action pipeline issues with ConvaiActionDebugProbe and a symptom/cause/fix reference.