# Importing Custom Characters

To import your custom characters into your Convai-powered Unity project, you will first need to bring your model into your project. The model needs at least two animations: one for talking and one for Idle.

## Prerequisites

When you want to set up your custom character with Convai, you will need your character model and two animations: Idle and Talking.&#x20;

Create an animator controller with the two animations that looks like this. You should also add a 'Talk' Boolean to ensure that you can trigger the animation. [Here is a YouTube tutorial on how to set up an animator controller](https://www.youtube.com/watch?v=JeZkctmoBPw\&t=53s). This is the bare minimum animator setup that you need to do.&#x20;

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FQj753RXbB7f1Ymc2zd6I%2Fimage.png?alt=media&#x26;token=a6076dda-3f0c-46af-8c40-e865da2f34a5" alt=""><figcaption><p>The animator controller should look like this. This is the in-box NPC Animator. </p></figcaption></figure>

### Step 1: Add Animator to your custom character

Select your character from the Hierarchy and Add Animator Component

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FTzrYC6rl02cgC08wcboa%2FScreenshot%202024-05-23%20195315.png?alt=media&#x26;token=d77aac8b-2ac6-4584-844a-78a28a5810a2" alt=""><figcaption><p>Screenshot showing newly added Animator Component</p></figcaption></figure>

Convai Plugin ships with two pre-made animation controller, you can choose these controllers or can assign your custom controller, whatever fits your need. For this demo we are going with `Feminine NPC Animator`

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FOS3lj5DS5SZPWoik1H42%2FScreenshot%202024-05-23%20195607.png?alt=media&#x26;token=45093646-82e0-4f05-a92a-673d70fc0044" alt=""><figcaption><p>Screenshot showing selection of Animation Controller</p></figcaption></figure>

### Step 2: Adding a Trigger Volume

With your custom character selected, add a Collision shape of your choice, for this demo we are going with a `Capsule Collider`

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FYKxA2s27ZKEX42h72OQA%2FScreenshot%202024-05-23%20200002.png?alt=media&#x26;token=1fbc4270-0548-422d-891f-e8ec6ee30233" alt=""><figcaption><p>Screenshot showing newly added Capsule Collider</p></figcaption></figure>

We will make this Collider a trigger, for this we will enable the `Is Trigger` option in the inspector panel

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F0zSKh2rRXqYbnHh5A6Do%2FScreenshot%202024-05-23%20200219.png?alt=media&#x26;token=7dfad8d7-f06e-47fa-8b9d-1b69aaed1313" alt=""><figcaption><p>Screenshot showing enable of Is Trigger option</p></figcaption></figure>

We will adjust the Center, Radius and Height of the collider such that it fits our character

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FGCGZc4qZ6lZ164Xjq8Rw%2FScreenshot%202024-05-23%20203103.png?alt=media&#x26;token=c92b6eca-b0f4-459e-ad6f-bf6ee7ba760f" alt=""><figcaption></figcaption></figure>

### Step 3: Add ConvaiNPC Component

With your Custom Character Selection add ConvaiNPC component. By doing so, your Game objectgame should look like this:

{% hint style="info" %}
We assume that nothing other than pre-instructed components were added by you; your Game Object component list may be different
{% endhint %}

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FCALznCPgACXOc3En6yxj%2FScreenshot%202024-05-23%20201324.png?alt=media&#x26;token=4379aab2-34af-4522-9661-883ffd7f14dc" alt=""><figcaption><p>Screenshot showing newly added ConvaiNPC Component</p></figcaption></figure>

Copy your character's ID and name from [Convai Playground](https://docs.convai.com/api-docs/convai-playground) and paste them here.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FPqKoJG9Q7Hp9NaMNOHK9%2FScreenshot%202024-05-23%20201727.png?alt=media&#x26;token=fa46d206-1fa8-495f-9312-dfaee24abed2" alt=""><figcaption><p>Screenshot showing filled-in character information.</p></figcaption></figure>

Now your Custom Character is all set to work with Convai Plugin.
