> For the complete documentation index, see [llms.txt](https://docs.ohalee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohalee.com/products/ultimateoneblock/installation.md).

# Installation

{% hint style="warning" %}
UltimateOneBlock requires **Java 21**, a **1.21+** server (Paper recommended), and the **VoidGen** plugin, which is a hard dependency used to generate the empty island world.
{% endhint %}

* Install **VoidGen** and UltimateOneBlock into the server `plugins` folder, then start the server once to generate the configuration and the island world.
* By default the plugin uses an embedded **H2** database and works with no extra setup.
* To use **MariaDB**, set `database.type` to `MariaDB` and fill in the `database.mariadb` credentials in `config.yml`.

## Optional dependencies

Install any of these to enable the matching feature:

* **Vault** — economy backend for the island reset cost.
* **PlaceholderAPI** — `%oneblock_*%` placeholders.
* **LuckPerms** — per-group island member limits (`custom-max-players`).
* **HolographicDisplays**, **DecentHolograms**, **FancyHolograms** or **CMI** — leaderboard/info holograms.
* **MythicMobs**, **ItemsAdder**, **Nexo**, **JetsMinions** — content integrations.