Spatial awareness

Give Convai characters a plain-language sense of where objects, other characters, and the player are around them, and why it matters.

Spatial awareness tells each Convai character where the objects, other characters, and the player are around it — how far away, in what direction, whether it can actually see them, and how nearby things relate to one another. The system computes this once per poll, in plain language, and delivers it to every chatbot as a set of context facts the AI reads alongside the conversation.

Spatial awareness replaced the older per-object proximity mechanism in 4.0.0-beta.22. If you have existing pages, Blueprints, or notes that describe per-object proximity, treat this section as the current model.

Use this section to understand the model, turn the feature on, and tune it for your project.

How spatial awareness works Understand distance bands, direction, facing, line of sight, relations, and how facts become the sentences a character receives.

Spatial awareness quick start Turn on spatial awareness, tune the distance bands, and confirm what a character receives in the debug overlay.

Describe objects from the player's view Make a character give directions from the player's own camera frame.

Merge same-named objects Merge same-named Convai Object Components into one logical object instead of leaving them as separate, numbered duplicates.

Spatial awareness settings reference Look up every spatial awareness and object-naming project setting, its default, and its edit condition.

Troubleshoot spatial awareness Fix a character that describes nothing, gets distances or directions wrong, hides objects behind walls, or mixes up duplicate names.