For the complete documentation index, see llms.txt. This page is also available as Markdown.

โœจFeatures

GUI

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

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

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.

Upgrade
Effect

Border

Extra island border size, capped by world-border.max-size

Generator speed

Percentage off generator delay, capped at 90%

Member slots

Extra members on top of the permission-based limit

Mob limit

Living entities allowed inside the island border

Hopper limit

Hoppers allowed per chunk inside the island

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.

Island chat

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.

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.

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.

Last updated