Narrative design

Drive character story graphs from Unreal Engine by invoking narrative triggers, injecting template keys, and handling section change events.

Narrative design gives a Convai character a structured story graph — named sections, named triggers, and template keys that adapt objectives to live gameplay data. You author the graph in the Convai dashboard; at runtime, UConvaiChatbotComponent (Convai Chatbot) invokes triggers and receives section changes from Convai.

New to narrative design? Start with How narrative design works to understand sections, triggers, and template keys. Then follow Narrative design quick start after you have a character with a graph configured in the dashboard. Use Narrative Design | Playground to create sections and triggers before you open Unreal Engine.

Get started

How narrative design works Understand sections, triggers, template keys, and the runtime pipeline from trigger call to section event.

Narrative design quick start Invoke a named trigger from Blueprint and confirm a section change by printing the new section ID.

Build and configure

Narrative triggers Use Invoke Narrative Design Trigger for named graph transitions and Invoke Speech for dynamic context events.

Template keys Populate the Narrative Template Keys map so section objectives reference live gameplay values.

Fetching narrative data Query a character's sections and triggers at runtime with Convai Fetch Narrative Sections and Convai Fetch Narrative Triggers.

Reference and support

Narrative design Blueprint reference Reference for Blueprint functions, events, properties, async fetch nodes, and narrative structs.

Narrative design usage examples Worked Blueprint recipes for linear progression, dynamic context events, template keys, and trigger validation.

Troubleshoot narrative design Fix section events that do not fire, wrong transitions, template keys that are ignored, fetch failures, and session readiness issues.

Next steps

Narrative design quick startNarrative Design | Playground