# 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](/plugin-usage/plugin-configuration/resourcepack-hosting.md) to decide the hosting method for the resourcepack.\
The best method is `self-host`.
{% endstep %}

{% step %}
**(recommended) Install ItemsAdderAdditions**

**ItemsAdderAdditions** is a plugin that adds new features, actions, behaviours. You can download on [Modrinth](https://modrinth.com/plugin/itemsadderadditions) or [SpigotMC](https://www.spigotmc.org/resources/itemsadderadditions.133918/)
{% endstep %}

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

![](/files/XjyVZ0on49nHOuarhqzT)

**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="/files/9748TQCWzx3xGEe47y5a" 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](/plugin-usage/plugin-configuration/resourcepack-hosting.md) 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="/files/AHf1SYXvo2kdiptq3W4J" alt=""></div>
{% endstep %}
{% endstepper %}


---

# 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://itemsadder.devs.beer/plugin-usage/first-install.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.