Gaze attention

Find guides and reference for the gaze attention system, which lets players direct a Convai character's focus by looking at world objects.

Gaze attention lets players direct a Convai character's focus by looking at tagged world objects. Enable it on UConvaiPlayerComponent, tag props with UConvaiObjectComponent, and the character can respond to what the player is looking at.

Gaze attention builds on scene metadata and character actions. Before you start, confirm your level has:

• At least one world actor tagged with UConvaiObjectComponent and a non-empty Name. See Scene metadata quick start if you have not tagged objects yet.
• Enable Actions checked on the chatbot under Convai | Actions → Environment. See Character actions quick start if actions are not configured.
• UConvaiPlayerComponent on the player pawn with Enable Gaze Attention turned on.

New to this feature? Start with How gaze attention works for the full pipeline, then follow Gaze attention quick start.

How gaze attention works Understand the trace pipeline, attention promotion timers, component-scoped targeting, and the attention-source locking rule.

Gaze attention quick start Enable gaze attention on the Player Component and verify that a character responds when the player looks at a tagged object.

Gaze attention reference Complete property, event, method, and class reference for all gaze attention components and their defaults.

Gaze attention usage examples Blueprint recipes for gaze events, custom highlight visuals, component-scoped targeting, and manual attention locking.

Troubleshoot gaze attention Diagnose and fix objects not highlighting, attention not promoting, cursor not appearing, and component-scoped gaze not matching.