# First Install

{% hint style="danger" %}
**Make sure** that all of your plugins and server software are up to date!\
**Always check** the version of ItemsAdder you are downloading!

* <mark style="color:red;">**v3 is only for 1.20.4 and lower**</mark>
* <mark style="color:red;">**v4 is only for 1.20.6 and greater**</mark>
  {% endhint %}

{% stepper %}
{% step %}
**Installing the plugin and libraries**

<details>

<summary>Click here to read v3 installation</summary>

* Stop the server.
* Put **ProtocolLib** JAR inside the `plugins` folder
  * Download 1.21.4 and older versions [here](https://github.com/dmulloy2/ProtocolLib/releases/)
* Put [**LoneLibs**](https://www.spigotmc.org/resources/lonelibs.75974/) JAR inside the `plugins` folder (not required on 4.0.9 and greater)
* Put the **ItemsAdder** JAR file inside your plugins folder
* Start the server
* Let **ItemsAdder** finish loading **everything**

</details>

* Put `ProtocolLib.jar` inside the `plugins` folder (Download [here](https://github.com/dmulloy2/ProtocolLib/releases/download/dev-build/ProtocolLib.jar) )
* Put the `ItemsAdder.jar` file inside the `plugins` folder
* Start the server
* Let **ItemsAdder** finish loading **everything**
  {% endstep %}

{% step %}
**Resourcepack first installation**

{% hint style="warning" %}
**Important Step**

Content <mark style="color:red;">**WILL NOT SHOW CORRECTLY**</mark> if you won't complete this step!
{% endhint %}

Before using the plugin you have to decide the resourcepack hosting method.\
Read [this tutorial](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/resourcepack-hosting) to decide the hosting method for the resourcepack.\
The best method is `self-host`.
{% endstep %}

{% step %}
**(optional) Add official ItemsAdder custom content**

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-fb056ca03a9797276c6f3b686f55499bac879b3c%2Fitems_showcase_gif.apng?alt=media)

**ItemsAdder** comes with a lot of custom content already created for you.\
It's not automatically included in the downloaded plugin because some people might not want every item/feature automatically added into their server.

{% embed url="<https://github.com/ItemsAdder/DefaultPack/releases>" %}

<div align="left"><figure><img src="https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-412b2804d2f1456e061c4d96d6543a7ccc297f05%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

* Extract the content into the `ItemsAdder` folder and overwrite the files if asked.
* Run the `/iazip` command.
* Follow your [hosting method](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/resourcepack-hosting) if you're not using **self-host**.
  {% endstep %}

{% step %}
**(optional) Add other ItemsAdder custom content**

**Download the Other Packs here:**

{% embed url="<https://github.com/ItemsAdder/OtherPacks/releases/latest>" %}

<div align="left"><img src="https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-af71193c0a478d1b0b34179959aa0e10a68f959e%2Fimage.png?alt=media" alt=""></div>
{% endstep %}
{% endstepper %}