World Hosting Strategies

How an island is physically stored is a separate decision from which mode it is. Each mode in config.yml picks one of three hosting strategies, so you can run a packed grid for one mode and dedicated worlds for another.

config.yml
modes:
  skyblock:
    hosting: grid
  oneblock:
    hosting: grid
  chunkblock:
    hosting: world_per_island

The three strategies

StrategyWhat it does
gridMany islands in one shared world on a spaced grid. The lightest option.
world_per_islandEach island gets its own world, copied from the mode's base world on create.
server_sharedIslands distributed across backend servers on a network.

grid

Every island sits at its own cell in one big world, spaced by island.grid-spacing blocks. This is the lightest on resources because there is only one world to keep loaded per map. Ideal for Skyblock and OneBlock where islands are small and self contained.

config.yml
island:
  grid-spacing: 1024   # blocks between island centers

world_per_island

Each island gets a genuinely separate world, made by copying the mode's base/template world at creation. Every island starts from identical terrain, and because it is a real separate world, it suits modes like ChunkBlock that rely on natural generation.

Folia and the world pool

Folia cannot create worlds at runtime, so for world_per_island it pre-generates a pool of ready worlds (island.world-per-island-pool-size) and hands one out per island. On Paper, worlds are created on demand with no restart.

server_shared

The networked option: per island worlds hosted locally on each backend, sharded across the network by this server's tag. This is the strategy that pairs with Proxy Sharding and needs the same shared database.

Nether and End on a grid

When per island Nether and End are enabled, each grid map gets a shared Nether and End world grid-packed at the same cell as the overworld, so an island's Nether sits directly beneath its claim. Portals inside an island relink to that island's own cell.

config.yml
island:
  environments:
    nether: true
    end: true
    platform-y: 101   # where a player lands in an empty void cell
Folia world declaration

On Folia, the worlds each strategy needs are declared in bukkit.yml so they are created at startup. Enabling a new mode or strategy needs one restart for its world to appear. On Paper there is no such restart.