# \[Addon] Wizard NPC

{% hint style="danger" %}
The section is for addons that you need to purchase separately to use. The default package does not include the features or assets in this section.

* Price: **$5.99**
  {% endhint %}

This Addon will provide you with 1 interactive **Wizard NPC** to open an **Enchanter**, combined with a short dialogue that will enhance the excitement of your server.

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

<figure><img src="/files/qShQjxlVmso4Q3h1QHKg" alt="" width="375"><figcaption></figcaption></figure>

## Requirements

{% hint style="danger" %}
Please note that this addon will only support server versions from **1.16.5 to 1.20.4** due to its dependency on **ModelEngine**.
{% endhint %}

| Name             | Link                                                                                                                                                      | Version                         | Required                                                |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------- |
| **Model Engine** | [**Download**](https://www.spigotmc.org/resources/conxeptworks-legacy-model-engine-1-16-5-1-20-4.79477/)                                                  | Latest v3, v4                   | Yes                                                     |
| **Citizens2**    | [**Download**](https://ci.citizensnpcs.co/view/Citizens/job/Citizens2/3399/)                                                                              | **2.0.33-b3399** for **1.20.4** | <mark style="color:orange;">**\[ See Caution ]**</mark> |
| **ItemsAdder**   | [**Purchase**](https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/)   | Latest                          | <mark style="color:orange;">**\[ See Caution ]**</mark> |
| **Nexo**         | [**Purchase**](https://polymart.org/resource/nexo.6901)                                                                                                   | Latest                          | <mark style="color:orange;">**\[ See Caution ]**</mark> |
| **Oraxen**       | [**Purchase**](https://www.spigotmc.org/resources/%E2%98%84%EF%B8%8F-oraxen-custom-items-blocks-emotes-furniture-resourcepack-and-gui-1-18-1-21-1.72448/) | Latest                          | <mark style="color:orange;">**\[ See Caution ]**</mark> |

{% hint style="warning" %}
&#x20;<mark style="color:orange;">**Caution ]**</mark>

**ItemsAdder**, **Nexo** and **Oraxen** - you **only need one** for your server to use our configuration package. **ItemsAdder & Nexo** are highly recommended.
{% endhint %}

## Installation

Remember to **back up your server** before proceeding with the installation.

1. After you download the package, you will simply have **4** folders: **CharacterDialogue**, **ItemsAdder**, **ModelEngine**, **Oraxen**.\ <br>

   <figure><img src="/files/gB0OdoOutOfh01vE7iaw" alt=""><figcaption></figcaption></figure>
2. If your server uses **ItemsAdder**, you can skip the **Oraxen** folder, and vice versa. Note that you only need one of those two plugins.
3. Copy **CharacterDialogue, ModelEngine** and **ItemsAdder/Oraxen** folder to your server plugins folder.
4. Restart your server, after you logged in your server, use the command below to zip and apply all the changes.\
   \- For **ItemsAdder** users: **/iazip**\
   **-** For **Oraxen** users: **/o reload all**
5. Using **Citizens**, create an NPC with any name (Wizard) by this command then remember the id of it  **`/npc create Wizard --type PIG --trait meg_model`**&#x20;
6. Then apply the Wizard NPC Model to the NPC by command, replace **\<npc-id>** with the id of your NPC in **Step 5**\
   \&#xNAN;**`/meg npc model citizens:<npc-id> add ae_wizard`**
7. Bind the id of the created NPC to **CharacterDialogue** plugin config, then reload the plugin by command: **`/characterd reload`**

{% code title="plugins/CharacterDialogue/config.yml" %}

```yaml
placeholders:
  npc: "&e[NPC] &c%npc_name%&f:"
  user: "&e[YOU] &b%player_name%&f:"
npc:
  "<npc-id>": ae_wizard # THE ID OF NPC WILL BE HERE
```

{% endcode %}

<br>


---

# 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://wiki.hyronic.dev/configurations/ae-enchant-ui-textures/addon-wizard-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.