Dynamic context

Find guides for pushing live state and events to Convai characters through Blueprint nodes and verifying context-aware responses in your level.

Dynamic context lets a Convai character know what is happening in your level right now — trainee health, current zone, equipment status, alarms, and narrative beats. You push updates from Blueprint through the Convai|DynamicContext node family on the Convai Chatbot component (UConvaiChatbotComponent).

Use dynamic context when a fact changes during gameplay and the character should be able to reference it in conversation. Use Set Context State for current conditions that can be replaced (for example, Health is 50). Use Add Context Event for one-time moments (for example, Alarm triggered in sector 4).

How dynamic context works Understand state properties, events, debounce batching, and when the character may respond.

Dynamic context quick start Push your first state and event in Blueprint, then verify the character can use the updated context.

Static context at connection time Understand what data is fixed at session start and how it differs from live dynamic context.

Sync behavior and timing Understand when updates flush, how offline queueing works, and when to use immediate flush.

Dynamic context Blueprint reference Reference for every `Convai|DynamicContext` node, property, enum, and transport field.

Dynamic context usage examples Blueprint recipes for health tracking, zone changes, narrative events, and session resets.

Troubleshoot dynamic context Fix updates that arrive too late, trigger unexpected responses, or appear ignored after a flush.

Recommended reading order

1. How dynamic context works — learn the state and event model.
2. Dynamic context quick start — push and verify your first update.
3. Static context at connection time — separate session-start facts from live updates.
4. Sync behavior and timing — tune flushing, queueing, and immediate sync behavior.
5. Reference, examples, and troubleshooting pages — use when you need exact node behavior, applied patterns, or a fix.

How dynamic context worksDynamic context quick start