> 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/unreal-engine/guides/dynamic-environment-info.md).

# Dynamic Environment Info

Transmit real-time environmental data to characters without requiring a response. Supported from Plugin Version 3.5.1.

## Overview

Dynamic Environment Info is a powerful feature that allows users to pass additional environmental data to characters without direct interaction. This enables more immersive and creative gameplay scenarios by enhancing how characters perceive their surroundings.

For example:

* The character can understand the **time of day** (e.g., "time of day is night").
* The character can access **inventory details** (e.g., "You currently have a gun and a healing potion").
* The feature supports structured data formats for richer information exchange.

***

Follow the steps below to integrate Dynamic Environment Info into your project.

1. Open the **Character Blueprint** in your project.
2. In the **Begin Play** event, locate the `ConvaiChatbot` component.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F2YNjgkKEafxVx4p64kk7%2Fimage.png?alt=media&amp;token=f9dcb823-26b3-4d88-9c87-b3488a35ffc8" alt=""><figcaption></figcaption></figure>

3. Set the `Dynamic Environment Info` variable with a string value of your choice.

* Example 1 (Simple):

  ```
  time of day is night
  ```

<div align="left"><figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FoeFoA65Ub43HZ7BNCwfN%2Fimage.png?alt=media&amp;token=18161eec-08b1-4396-97bd-9f32b20f88fb" alt=""><figcaption></figcaption></figure></div>

* Example 2 (Structured Format):

  ```
  inventory: {weapon: gun, tools: [flashlight, rope]}
  ```

<div align="left"><figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FDN0Vkia5Z7nzyPpk0Lxk%2Fimage.png?alt=media&amp;token=5c0581c2-b482-4da3-900b-c977657d450d" alt=""><figcaption></figcaption></figure></div>

**Save and Play**

1. Save your blueprint changes.
2. Hit **Play** to test the interaction.
3. Observe how the character dynamically responds based on the information passed.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fm7JcmjIjRs79EW27fSUB%2Fimage.png?alt=media&amp;token=2ec8bcfb-0b7e-423f-9d3b-391b220c2040" alt=""><figcaption></figcaption></figure>

***

By following these simple steps, you can unlock more engaging gameplay mechanics and enrich the interactions.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/unreal-engine/guides/dynamic-environment-info.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
