# Installation

## STEP 1

Make sure that your server is using PAPER JAR on 1.21.6 and stop your server. Also you will need Java 21 at your server to run the setup.

{% hint style="info" %} <mark style="color:green;">**NOTE:**</mark> If you don't have the option at your server's webpanel to select the version for your&#x20;server, you can download the latest Paper 1.21.6 server jar from here:\ <mark style="color:green;"><https://papermc.io/downloads/paper></mark>
{% endhint %}

If you already have any plugin (or plugin folder) from the setup on your server, delete them&#x20;and add the files inside of the "plugins" folder from the setup.

## STEP 2

Download the setup dependencies:

{% hint style="info" %}
ItemsAdder v4.0.12 (tested version)

[**Download it here**](https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/history)
{% endhint %}

{% hint style="info" %}
Citizens Plugin v2.0.39 (1.21.8 BUILD #5) (tested version)

[**Download it here**](https://drive.google.com/file/d/1G3lAHBBQe9-dAcnrrclFLD2LZtoXvWKS/view?usp=sharing)
{% endhint %}

Remember to use the specified versions to avoid errors.&#x20;Once you downloaded the both dependencies, just drag & drop them into the <kbd>/plugins</kbd> folder.

## STEP 3

Start your server and look up at the console for any error. You may notice that once started (if you 've added the correct dependencies at the specified versions) it ask you for a license, you can see how HyperLicense works below.

{% content-ref url="../hyperlicense-system" %}
[hyperlicense-system](https://hyperdevs-setups.gitbook.io/docs/setups/hyperlicense-system)
{% endcontent-ref %}

## STEP 4

As last step, you need to choose a method to host your resourcepack, you can find them here:\\

{% embed url="<https://itemsadder.devs.beer/plugin-usage/resourcepack-hosting>" %}

We highly recommend to use the <kbd>"Self-Hosting"</kbd> method if you have extra open ports at your server,  or to choose <kbd>"Lobfile"</kbd> method if you don't.

<table><thead><tr><th width="154">HOSTING METHOD</th><th>Needs an extra open port</th><th width="84">Free</th><th>Speed of downloading</th></tr></thead><tbody><tr><td><kbd><mark style="color:green;"><strong>Self Hosting</strong></mark></kbd></td><td>Yes</td><td>Yes</td><td>⭐⭐⭐⭐⭐</td></tr><tr><td><kbd><mark style="color:green;"><strong>Lobfile</strong></mark></kbd></td><td>No</td><td>Yes</td><td>⭐⭐⭐⭐</td></tr></tbody></table>

## STEP 5

Once you decided your hosting method you need to join your server, and as OP run the command <kbd>/iazip</kbd>, and&#x20;wait for the resourcepack to be re-applied.&#x20;

If you 've followed the steps correctly, the setup&#x20;should be working!

{% hint style="success" %} <mark style="color:green;">**NOTE**</mark>: Remember when you add the server IP on in-game multiplayer menu, to set the&#x20;resourcepack on: "Enabled".
{% endhint %}
