> 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-unity-sdk/embodiment/quick-start.md).

# Embodiment quick start

Add the Gaze module to an existing Convai character so it makes eye contact with the player, visible immediately in Play mode.

Add the Gaze module to an existing Convai character and confirm that the character makes eye contact with the player in Play mode. Use this page once you have a working `ConvaiCharacter` in your scene and want to see embodiment behavior for the first time before configuring the other four modules.

***

### Prerequisites

* A `ConvaiCharacter` in your scene that already connects and responds — complete [Validate your setup](/api-docs/plugins-and-integrations/convai-unity-sdk/getting-started/validate-your-setup.md) first if you have not.
* An `Animator` on the character. A **Humanoid** rig lets Convai map the head and eyes automatically; a **Generic** rig works too once a `Character Rig` binding assigns at least the head.

{% hint style="info" %}
You do not need to author a settings asset before trying a module. Every module runs on built-in defaults tuned to look right — a profile is for reshaping the behavior later, not for turning the module on.
{% endhint %}

***

### Add the Gaze module

{% stepper %}
{% step %}

#### Select the character

In the Hierarchy, select the `GameObject` that carries the `ConvaiCharacter` component.
{% endstep %}

{% step %}

#### Add the Gaze component

In the Inspector, select **Add Component**, then **Convai > Embodiment > Gaze**. This adds `ConvaiGazeController` to the character.

Convai also adds the shared infrastructure the module needs — an `EmbodimentContext` and a `StandardRigBinding` — automatically. You do not add these yourself.
{% endstep %}

{% step %}

#### Review the rig detection

Open **Convai > Embodiment Editor** and select the **Setup** tab. Select **Set Up This Character** to see which face-blendshape convention Convai detected and how confident that detection was, and which bones resolved.

This step is optional — Gaze already works without it — but it is how you see what Convai worked out before you enter Play mode.
{% endstep %}
{% endstepper %}

***

### Verify the setup

Enter Play mode and start a conversation with the character. Gaze's default eye contact mode is `Natural` — the character's eyes and head should visibly track you as you move around it, instead of staying fixed on a point in space.

{% hint style="success" %}
**Expected result:** the character's head and eyes turn toward you shortly after the conversation starts, and continue to track your position while the conversation is active.
{% endhint %}

***

### Troubleshooting

If the character's eyes and head do not move, open **Convai > Embodiment Editor > Setup** and check the detected rig convention and its confidence — a low-confidence detection is the most common cause. See [Character rig setup](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/character-rig-setup.md) to fix bone or blendshape mapping, or [Troubleshoot embodiment](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/troubleshooting.md) for the full set of failure modes.

***

### Next steps

{% content-ref url="/pages/EpVlILP94SrOHCZlXqvF" %}
[How embodiment works](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/how-embodiment-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/4vBSJ7Fjndr7KbLT4hAp" %}
[Character rig setup](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/character-rig-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/UbtubfC4hHpNPmgYPkJE" %}
[Embodiment presets](/api-docs/plugins-and-integrations/convai-unity-sdk/embodiment/embodiment-presets.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-unity-sdk/embodiment/quick-start.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.