# Add NPC

## Overview

The Add NPC feature in SiEGA allows users to create immersive and interactive non-player characters (NPCs) to communicate with the users through a voice and chat box interface. Powered by ConvAI, this feature enables users to design unique NPCs with detailed backstories, providing dynamic interactions within the SiEGA environment.

## Features

* Dynamic Interactions: Engage with NPCs powered by advanced AI, allowing for realistic and varied conversations.
* Seamless Spawn and Placement: Easily add NPCs to your environment and adjust their placement to suit your needs.
* Enhanced Knowledge Banks: Easily upload your own knowledge bank to your ConvAI character while creating them, or simply select an existing character with a prefilled knowledge bank.

## Demo

{% embed url="<https://youtu.be/XVgRszhGGwE>" %}

{% embed url="<https://www.youtube.com/watch?v=x0cZFB69T2U>" %}
Here is an additional video that provides a walkthrough of the We the People Museum within the SiEGA environment, showcasing various NPCs in action.
{% endembed %}

## Setting Up a Character in Convai

Sign up for a free account on [convai.com](https://convai.com/), once your account is setup you will be brought to the convai dashboard.

Select create character to begin the character creation process

<figure><img src="/files/8sDpG28Q0edVFbrxxNpo" alt=""><figcaption></figcaption></figure>

To create a character you will do the following steps:

* Create a character description including the character's name, voice, and backstory
* Actions, this can be left blank if desired
* Select a language for the character
* Configure avatar, where you change the appearance in convai

<figure><img src="/files/yO7s7cALheIFwpYVbksW" alt=""><figcaption></figcaption></figure>

Throughout the character creation process the most important step is to focus on the character backstory. This will define who your NPC is and helps establish their identity. Think about their history, motivations, and personality traits as this will affect interactions with users.&#x20;

<figure><img src="/files/fgarFRNd2lqBD4PBCDr8" alt=""><figcaption></figcaption></figure>

Once all the relevant information has been filled out you can select the **Create Character** button on the configure avatar section.

<figure><img src="/files/mdY7quFsIrgSSRPv5RZL" alt=""><figcaption></figcaption></figure>

You should now be able to access all of the other character settings and be able to obtain your character's id. Please copy this character ID and store it someplace that is easy to access on your computer, such as your computer's notepad application.\
\
\*Note that the character AI can be further trained with the knowledge bank setting.

<figure><img src="/files/Ib15p7KykC7tRpJ4hTxR" alt=""><figcaption></figcaption></figure>

Now, head to the top of the screen where you see the key icon right next to your profile. Upon clicking on this icon, a drop-down menu will appear below the icon which will show an API Key which is hidden by default. Click the copy button next to the hidden code and store the key someplace where you can access it again easily (your desktop notepad application).<br>

<figure><img src="/files/AOf3BP98YNfmPWpikHKu" alt=""><figcaption></figcaption></figure>

## How to Use

Open the Actions menu and select the Add NPC option. This action can be performed from either walk mode (as seen in the image below) or fly mode. <br>

<figure><img src="/files/4owcv61xt5mdiBrOdKDe" alt=""><figcaption></figcaption></figure>

To Add an NPC into SiEGA:

* Select a MetaHuman to represent your NPC
* Copy the API Key from your location on your desktop and paste it into the section labeled "API Key"
* Enter the Character ID from your desired Convai character to link it with the selected MetaHuman

<figure><img src="/files/3wfIOMzs295zf2q65qAv" alt=""><figcaption></figcaption></figure>

Use the HUD to position your MetaHuman precisely within the environment. To access the coordinate axis gizmo, you must first click the select icon on the right hand side of the screen to enter "Select Mode" where you will then be able to use your mouse pointer to left click on the NPC. Then the coordinate gizmo will appear and you will be able to interact, move, and scale the NPC while in Select Mode.<br>

<figure><img src="/files/1tYY311gYOOqdIFWHNbM" alt=""><figcaption></figcaption></figure>

To engage with your newly created NPC, hold the **V** key and speak, or type your message into the chat box.

<figure><img src="/files/oywaF02Tey7PqvlZWBH4" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.aeroai.io/siega-features/actions/add-npc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.