# Creating a Character and Connecting it to an NPC in GPTTalk

**Step 1: Create a Character**

You'll first need to create a character within the plugin. Use the following command:

```
/gpttalk create <characterid> <name/name lastname>
```

Replace `<characterid>` with a unique identifier and `<name/name lastname>` with the character's name.

For example, to create a character with the ID "laracroft" and the name "Lara Croft" use the following command:

```
/gpttalk create laracroft Lara Croft
```

**Step 2: Configure the Character**

Open the character's configuration file and update the following attributes:

* **character-id:** Unique identifier for the personality (e.g., "laracroft").
* **character-name:** Display name of the character (e.g., "Lara Croft").
* **character-role:** Role or theme of the character (e.g., "A farmer, tending to crops and livestock with a strong connection to the land, embodying honesty and hard work.").
* **character-prefix:** Prefix displayed when the AI is talking.
* **permission-node:** Required permission node to use this personality.
* **rank-group-placeholder:** Placeholder to define the time limitations for conversation storage.
* **storage-limitations:** Defines the time limits for conversation storage (e.g., 3 days for default, 1 week for VIP+).
* **interactions:** Sets daily/weekly/monthly limits for interactions with the AI.
* **player-format:** Formats the player name using placeholders.
* **template-prompt:** The initial prompt to set the tone for the AI.
* **greet-prompt:** The greeting prompt to start a new conversation.
* **greet-when-resumed-prompt:** The greeting prompt to resume a conversation.
* **ongoing-resume-request-prompt:** A prompt triggered during ongoing conversations.
* **final-resume-request-prompt:** A prompt to request a summary of the whole conversation.

Here's a snippet of the configuration for a character named "Lara Croft":

```
character-id: laracroft
character-name: "Lara Croft"
character-role: "Adventurer"
character-prefix: "Lara Croft:"
```

You can continue to configure other settings as needed, following the provided documentation.

**Step 3: Connect the Character to an NPC**

Once the character is created and configured, you can connect it to an NPC using the following command:

```
/gpttalk npc <id> <characterid>
```

Replace `<id>` with the NPC's ID and `<characterid>` with the character ID you created earlier.

Example:

```
/gpttalk npc 123 laracroft
```

This will connect the "Lara Croft" character to the NPC with ID 123.

#### Additional Commands

Here are some other useful commands:

* **Unbind NPC from character:** `/npc sel` --> `/trait remove gpttalk`
* **Start and Stop Talking:** `/gpttalk start <characterid>` and bye or`/gpttalk stop`.
* **Set Interactions:** `/gpttalk set interactions <user> <npc> <quantity> <frequency>`.
* **Set Storage:** `/gpttalk set storage <user> <characterid> <quantity> <frequency>`.
* **Reload Configuration:** `/gpttalk reload`.
* **Delete a Character:** `/gpttalk delete <characterid>`.
* **Reset Interactions or Storage:** `/gpttalk reset <interactions/storage> <user> <characterid>`.

By following these steps and utilizing these commands, you can create rich, interactive characters like Lara Croft and NPCs in your Minecraft world, adding depth and engagement to the player experience.


---

# 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://aida-3.gitbook.io/gpttalk-wiki/tutorial/how-to-start/creating-a-character-and-connecting-it-to-an-npc-in-gpttalk.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.