> 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/spatial-awareness.md). # 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.	How spatial awareness works
Spatial awareness quick start Turn on spatial awareness, tune the distance bands, and confirm what a character receives in the debug overlay.	Spatial awareness quick start
Describe objects from the player's view Make a character give directions from the player's own camera frame.	Describe objects from the player's view
Merge same-named objects Merge same-named Convai Object Components into one logical object instead of leaving them as separate, numbered duplicates.	Merge same-named objects
Spatial awareness settings reference Look up every spatial awareness and object-naming project setting, its default, and its edit condition.	Spatial awareness settings reference
Troubleshoot spatial awareness Fix a character that describes nothing, gets distances or directions wrong, hides objects behind walls, or mixes up duplicate names.	Troubleshoot spatial awareness

--- # 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/spatial-awareness.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.