> 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-unreal-engine-plugin/features/narrative-design.md). # Narrative design 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](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/narrative-design/how-narrative-design-works.md) to understand sections, triggers, and template keys. Then follow [Narrative design quick start](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/narrative-design/narrative-design-quick-start.md) after you have a character with a graph configured in the dashboard. Use [Narrative Design | Playground](/api-docs/convai-playground/character-customization/narrative-design.md) 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.	/pages/5UHlXoAxUOLuWB0TElfn
Narrative design quick start Invoke a named trigger from Blueprint and confirm a section change by printing the new section ID.	/pages/9naQ9wL6wpdxFfJuDkfH

### Build and configure


Narrative triggers Use `Invoke Narrative Design Trigger` for named graph transitions and `Invoke Speech` for dynamic context events.	/pages/Khv7SfpK36SvMkUjcjoW
Template keys Populate the `Narrative Template Keys` map so section objectives reference live gameplay values.	/pages/WlLowI3BqDYQNs4lfQM4
Fetching narrative data Query a character's sections and triggers at runtime with `Convai Fetch Narrative Sections` and `Convai Fetch Narrative Triggers`.	/pages/9dcZ9ULB2iFBCZcNEu6i

### Reference and support


Narrative design Blueprint reference Reference for Blueprint functions, events, properties, async fetch nodes, and narrative structs.	/pages/7L5OLPdjT22ynoNiU7gD
Narrative design usage examples Worked Blueprint recipes for linear progression, dynamic context events, template keys, and trigger validation.	/pages/Y84uFwti8p03e69iFquR
Troubleshoot narrative design Fix section events that do not fire, wrong transitions, template keys that are ignored, fetch failures, and session readiness issues.	/pages/uGDfbeU2MRjQlg7HV1GY

### Next steps {% content-ref url="/pages/9naQ9wL6wpdxFfJuDkfH" %} [Narrative design quick start](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/narrative-design/narrative-design-quick-start.md) {% endcontent-ref %} {% content-ref url="/pages/bHvht3CwA8bDmCDcwdcd" %} [Narrative Design | Playground](/api-docs/convai-playground/character-customization/narrative-design.md) {% endcontent-ref %} --- # 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-unreal-engine-plugin/features/narrative-design.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.