> 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/features.md).

# Features

## GUI

Manage everything about your island from a single menu — members, visitors, bans, toggles and live island info.

<figure><img src="/files/o52YyWRMKcvKdZrgtWNP" alt=""><figcaption></figcaption></figure>

## Phases

Progress your island through a long chain of **phases** (Plains, Forest, Desert, Cave, Nether, End, Ancient City and many more — 20 ship by default). Each phase defines its own blocks, item drops, enchantment drops and mob spawns. Advancing far enough unlocks the next phase automatically.

## Title & Info

<figure><img src="/files/o52YyWRMKcvKdZrgtWNP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/o52YyWRMKcvKdZrgtWNP" alt=""><figcaption></figcaption></figure>

## Roles & Members

Islands are shared. Each player on an island holds a role — **Owner**, **Moderator**, **Trusted** or **Visitor** — and members can be invited, promoted, demoted, kicked or banned. The number of members allowed is controlled per permission group via `custom-max-players`.

## Island bank

`/is bank` opens a shared balance per island. Any member can pay in with `/is bank deposit <amount>`; only the owner and moderators can take money out with `/is bank withdraw <amount>`.

The bank is the plugin's own balance rather than an economy account, so the shop and upgrades work **even with no economy plugin installed** — only moving money in and out of a player's wallet needs Vault.

## Island shop

`/is shop` opens a paginated sell menu driven by `worth.yml`. Left click sells one stack, right click sells every matching stack, and the proceeds go into the island bank.

Items carrying a display name, lore or enchantments are never sold, so a named or enchanted tool cannot be lost to a mistimed click.

## Island upgrades

`/is upgrades` are bought from the island bank by the owner or a moderator. Tiers, costs and values are all configured in `upgrades.yml` — delete a section to switch that upgrade off.

<table><thead><tr><th width="220">Upgrade</th><th>Effect</th></tr></thead><tbody><tr><td>Border</td><td>Extra island border size, capped by <code>world-border.max-size</code></td></tr><tr><td>Generator speed</td><td>Percentage off generator delay, capped at 90%</td></tr><tr><td>Member slots</td><td>Extra members on top of the permission-based limit</td></tr><tr><td>Mob limit</td><td>Living entities allowed inside the island border</td></tr><tr><td>Hopper limit</td><td>Hoppers allowed <strong>per chunk</strong> inside the island</td></tr></tbody></table>

## Per-role island settings

`/is flags` opens a matrix of what each role may do — eight settings in total:

* **Per role** — Build, Break, Containers, Flight.
* **Whole island** — PvP, Mob spawning, Visitor access, Redstone.

Islands store only what they have explicitly changed, so editing a default under `island-flags` in `config.yml` reaches every island that never touched that setting. The shipped defaults reproduce the classic behaviour exactly: members may act on the island, visitors may not, and PvP is off. PvP is read from the island the *victim* is standing on, so shooting in from outside the border does not bypass it.

## Island home & warps

* `/is sethome` — moves where `/is` lands. Owner and moderators only.
* `/is warp set <name> [public]` — name a place on your island.
* `/is warp go <name>` / `/is warp delete <name>`, with tab completion.
* `/is warp` — browse every public warp on the server, with the island's owner and level. Public warps still honour bans and visitor access.

Homes and warps must be inside the island border, so neither can drop members into the void or onto someone else's island. Nine warps per island.

## Leaderboards & island value

`/is top` opens a paginated ranking menu, switchable between **level**, **island value** and **blocks mined**.

**Island value** is a block-worth score built from `worth.yml`, maintained as blocks are placed and broken. It is incremental — adding a block to `worth.yml` does not retroactively count the ones already standing.

**Hologram leaderboards** can be configured in any number under `tops.holograms` in `config.yml`, using whichever hologram plugin you already have.

<figure><img src="/files/V9OjnsWi7UQeCq1bOSek" alt=""><figcaption></figcaption></figure>

## Island chat

<figure><img src="/files/10xvVBztDsYWuOFX8L4h" alt=""><figcaption></figcaption></figure>

## Visiting & Open/Close

Islands can be opened to visitors with `/is open` (and closed again with `/is close`), and other players can drop in with `/is visit <player>`.

## Generators

Give players placeable **generators** that periodically produce a weighted pool of blocks (wood, redstone, prismarine, amethyst, nether, dripstone…). Fully configurable in `generators.yml` — see [generators.md](/products/modern-oneblock/generators.md).

## World Border

Each island is bounded by a resizable world border. Staff can expand a player's border with `/oneblockborder add <player> <size>` up to `world-border.max-size`, and players can buy extra size through the Border upgrade.

## MiniMessage support

Setting `text-format: MINIMESSAGE` in `config.yml` switches the whole plugin over to MiniMessage (`<green>tags</green>`). The default stays `LEGACY` so existing files keep their meaning; switching does not convert your files for you.

## Placeholders & Leaderboards

Exposes `%oneblock_*%` placeholders including per-island stats, island value, bank balance, rank and top-island leaderboards. See [placeholders.md](/products/modern-oneblock/placeholders.md).

<figure><img src="/files/yJBBgPtYv8mPLE3hpYzl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6rl9bqToMyN7z9Y3sXh0" alt=""><figcaption></figcaption></figure>

## Integrations

Optional hooks are available for **Vault** (moving money between a player and the island bank), **PlaceholderAPI**, **LuckPerms** (member limits), **MythicMobs**, **ItemsAdder**, **Nexo** and **JetsMinions**.