Character actions

Find guides, references, and examples for the Convai Unreal Engine character actions system — from quick start to Blueprint API reference.

When a player speaks to a Convai character, the plugin can make the character physically respond — walking to objects, following the player, or performing custom behaviors. Use this section to set up and configure character actions, write Blueprint handlers, and work with parameters and attention grounding.

How character actions work Understand what character actions are, when they are queued, and how Blueprint handlers run.

Character actions quick start Enable actions, add the default handlers, set up pawn movement and NavMesh, register scene objects, and test movement.

Configuring actions Define the action set, enable the feature on the chatbot component, and register environment objects and characters.

Built-in action handlers Implement Blueprint handlers for the default navigation, follow, stop, and wait behaviors.

Building custom action handlers Write Blueprint event handlers that receive and complete action structs dispatched by the chatbot.

Parameterized actions Declare typed inputs on action templates and read resolved values in Blueprint handlers.

Attention and reference grounding Understand how the chatbot resolves object references and attention targets in action responses.

Actions Blueprint reference Look up the Blueprint structs, events, enums, and queue functions used by character actions.

Character actions examples End-to-end action recipes: navigating to an object, following a character, and using parameterized actions.

Troubleshoot character actions Fix actions that are not firing, NavMesh and movement issues, and parameters that are not resolving correctly.