> 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/modern-oneblock/installation.md).

# Installation

{% hint style="warning" %}
Modern OneBlock requires **Java 25** and a **Minecraft 26.1+** server. **Paper** and **Folia** are both supported.
{% endhint %}

* Drop `ModernOneBlock-26.1.0.jar` into the server `plugins` folder, then start the server once to generate the configuration and the island world.
* **VoidGen is no longer required.** The islands world is generated by a bundled void generator, so you can uninstall VoidGen.
* 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`.
* Data lives in `plugins/ModernOneBlock/`. If you are updating from 1.0.8, read [upgrading.md](/products/modern-oneblock/upgrading.md) — your old `plugins/OneBlock/` folder is moved for you.

## Optional dependencies

Install any of these to enable the matching feature:

* **Vault** — moving money between a player's own balance and the island bank. The bank, shop and upgrades work without it.
* **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.
