> For the complete documentation index, see [llms.txt](https://zessentials.groupez.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zessentials.groupez.dev/getting-started/installing-zessentials.md).

# Installing zEssentials

## Purchase zEssentials

{% hint style="info" %}
The plugin is sold for **20€**, but the price may vary between sites for various reasons.
{% endhint %}

* **Spigot**: [https://www.spigotmc.org/resources/118014/](https://www.spigotmc.org/resources/zessentials-best-essentials-cmi-sunlight-alternative.118014/)
* **GroupeZ**: [https://groupez.dev/resources/](https://groupez.dev/resources/zessentials-best-essentialscmisunlight-alternative.325)[325](https://groupez.dev/resources/zessentials-best-essentialscmisunlight-alternative.325)
* **BuiltsBuyBits**: [https://builtbybit.com/resources/46047/](https://builtbybit.com/resources/zessentials.46047/)

## Requirements

* **Java version**: 17 or newer
* **Server version**: <mark style="color:red;">1.20.4</mark> / <mark style="color:red;">**1.20.6**</mark> / <mark style="color:red;">**1.21**</mark> / <mark style="color:red;">**1.21.1**</mark>
* **Server SoftWare**: [<mark style="color:orange;">Spigot</mark>](#user-content-fn-1)[^1], <mark style="color:green;">Paper</mark>, <mark style="color:green;">Folia</mark>, <mark style="color:green;">Pufferfish</mark>, <mark style="color:green;">Purpur</mark>, <mark style="color:green;">UniversSpigot</mark> *(all forks based on paper will work)*
* [**zMenu**](https://www.spigotmc.org/resources/zmenu-ultra-complete-menu-plugin.110402/) <mark style="color:red;">**REQUIRED**</mark>
* [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/) <mark style="color:red;">**REQUIRED**</mark> (Folia version [here](https://github.com/Anon8281/PlaceholderAPI/releases/tag/1.1))
* [**Vault**](https://www.spigotmc.org/resources/vault.34315/) <mark style="color:yellow;">**RECOMMANDED**</mark> (Folia version [here](https://github.com/Geolykt/Vault/releases))

{% hint style="warning" %}
**Attention:** Modded server software is not supported!
{% endhint %}

## Installation

1. Download zEssentials and its requirements.
2. Add **jars files** in `/plugins/` folder.
3. Start your servers
4. Configured the plugin, changed the storage from **JSON** to **MYSQL**.
5. Rebooted your servers, and <mark style="color:red;">voila</mark> the plugin is ready to be used!

{% hint style="danger" %}
It is important not to leave the storage in **JSON**, as this format does not support all the functionality of the plugin.
{% endhint %}

[^1]: It is not recommended to use spigot, you will not be able to enjoy all the features of the plugin.