---
description: >-
  Creating a character and connecting it to an NPC (Non-Player Character) within
  Minecraft through the GPTTalk plugin allows for immersive and dynamic
  interactions. Here’s how you can do it
---

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