> 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/long-term-memory/configure-memory-for-a-character.md).

# Configure memory for a character

Configure a Convai character so it can remember returning players. Enable the character-level LTM setting, verify it is active, and reset the local conversation link when you need a fresh thread.

### Prerequisites

* The Convai Unreal Engine plugin is installed and the API key is configured.
* The character Actor has a `UConvaiChatbotComponent` with a valid `CharacterID`.
* Player identity is configured. See [End-user identity](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/long-term-memory/end-user-identity.md).

### Enable LTM for the character

LTM is disabled by default on new characters in the Convai dashboard. Enable it for every character that should build persistent memory.

{% stepper %}
{% step %}

#### Check the current status

Add **Convai Get LTM Status** from the `Convai|LTM` category.

Set **Character ID** to the character ID from the Convai dashboard. The **On Success** delegate returns **Status** as a `bool`.
{% endstep %}

{% step %}

#### Enable memory if needed

If **Status** is `false`, call **Convai Set LTM Status** with the same **Character ID** and **B Enable** set to `true`.

Bind **On Success** to a visible confirmation such as **Print String** while testing.
{% endstep %}

{% step %}

#### Verify the setting

Call **Convai Get LTM Status** again. Continue only when **Status** returns `true`.
{% endstep %}
{% endstepper %}

### Reset the conversation link

Use `ResetConversation()` when the player starts a new playthrough, switches profiles, or needs a fresh conversation session without deleting long-term memory.

{% tabs %}
{% tab title="Blueprint" %}
Call **Reset Conversation** on the **Convai Chatbot** component.
{% endtab %}

{% tab title="C++" %}

```cpp
ChatbotComponent->ResetConversation();
```

{% endtab %}
{% endtabs %}

`ResetConversation()` sets the local `SessionID` property to `"-1"`. It does not delete the player's Speaker ID or individual memory records from Convai. The same `EndUserID` continues to scope long-term memory for that player.

{% hint style="info" %}
`UConvaiChatbotComponent.SessionID` defaults to `"-1"` and is cleared by `ResetConversation()`. The WebRTC connection does not send this property. Use it for local reset tracking or HTTP Bot Query flows.
{% endhint %}

### Verify the configuration

Before `StartSession`, confirm:

* **Convai Get LTM Status** returns `true`.
* `UConvaiChatbotComponent.EndUserID` is set to a non-empty, stable value.
* `SessionID` is `"-1"` after `ResetConversation()`, or unchanged when you are continuing with the same identity.

For identity assignment steps, see [End-user identity](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/long-term-memory/end-user-identity.md).

### Next steps

{% content-ref url="/pages/tyOWumFxG4lNGELvqAOH" %}
[Long-term memory usage examples](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/long-term-memory/long-term-memory-usage-examples.md)
{% endcontent-ref %}

{% content-ref url="/pages/mwNxFe292Uo2iGpZiLAp" %}
[LTM Blueprint reference](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/long-term-memory/ltm-blueprint-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/rHYMia3zb5OAQe1S06cT" %}
[Troubleshoot long-term memory](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/long-term-memory/troubleshoot-long-term-memory.md)
{% endcontent-ref %}


---

# 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/long-term-memory/configure-memory-for-a-character.md?ask=<question>&goal=<endgoal>
```

`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.