The modern
Skyblock plugin.

Step-by-step

Optional Plugins

Minimum config changes

After the first startup, only a few files really need editing for a basic server:

# These world names must match actual worlds on your server
[worlds.sky-overworld]
environment = "NORMAL"
portal-nether = "sky-nether"
portal-end    = "sky-end"
generator     = "default"   # void world

[worlds.sky-nether]
environment   = "NETHER"

[worlds.sky-end]
environment   = "THE_END"

[default-island]
default-schem-key = "starter"

[island.starter]
id          = "starter"
size        = 50.0    # 50 blocks in each direction from center
max-members = 6

["starter.sky-overworld"]
schematic         = "./schematics/starter.schem"
height            = 64.0
ignore-air-blocks = true
copy-entities     = true
plugin            = "WorldEdit"

First steps in-game

Island types define the different "starter" templates players can choose from when running /island create. Each type can have a different size, member limit, and starting schematic.

# The type used when the player doesn't specify one
[default-island]
default-schem-key = "starter"

# A small starter island
[island.starter]
id          = "starter"
size        = 50.0
max-members = 6

# A larger VIP island
[island.vip]
id          = "vip"
size        = 120.0
max-members = 20

Admin commands for island sizes

Admins can override the size or member count for a specific player's island at runtime:

Skyllia manages its own set of worlds separate from the main server worlds. Each world can be linked to Nether and End portals so players move seamlessly between dimensions.

[worlds.sky-overworld]
environment   = "NORMAL"     # NORMAL | NETHER | THE_END
portal-nether = "sky-nether" # which world nether portals lead to
portal-end    = "sky-end"    # which world end portals lead to
generator     = "default"   # "default" = void, or a plugin generator name
biome-id      = "minecraft:plains"

[worlds.sky-nether]
environment   = "NETHER"
portal-nether = "sky-overworld"
biome-id      = "minecraft:basalt_deltas"

Skyllia supports three database backends. By default, SQLite is used — perfect for small to medium servers with no external database setup required.

[postgres]
enabled   = true
hostname  = "127.0.0.1"
port      = 5432
database  = "skyblock"
username  = "your_user"
password  = "your_password"
useSSL    = false
minPool   = 2
maxPool   = 10

    
[mariadb]
enabled   = true
hostname  = "127.0.0.1"
port      = 3306
database  = "skyblock"
username  = "your_user"
password  = "your_password"
useSSL    = false
minPool   = 2
maxPool   = 10

[sqlite]
enabled   = false   # disable SQLite when using MariaDB
file      = "plugins/Skyllia/skyllia.db"   # Path to the SQLite file used.

Controls what happens to a player's inventory, ender chest, and experience in various island lifecycle situations.

Teleport on Join

Schematics define what structure is pasted when a new island is created. Each island type + world combination gets its own schematic entry.

# Format: ["islandTypeId.worldName"]
["starter.sky-overworld"]
schematic         = "./schematics/starter_overworld.schem"
height            = 64.0
ignore-air-blocks = true
copy-entities     = true
plugin            = "WorldEdit"

["starter.sky-nether"]
schematic         = "./schematics/starter_nether.schem"
height            = 64.0
ignore-air-blocks = true
copy-entities     = false
plugin            = "WorldEdit"

Role hierarchy rules

A player can only manage roles strictly below their own. This means:

An Owner can promote/demote anyone. A Co-Owner can manage Moderators and Members but not other Co-Owners. A Moderator can manage Members but not Co-Owners, etc.

Managing roles in-game

Permissions control what actions each role can perform on an island. These are the defaults for all islands — players with the right role can further toggle these in-game via /island permission.

Available permissions

[defaults.MEMBER]
"skyllia:block.break" = true
"skyllia:block.place" = true
"skyllia:block.interact" = true
"skyllia:item.pickup" = true
"skyllia:item.drop"   = true

In-game permission management

Flags are island-wide environmental toggles — they don't depend on who is doing the action. They control things like whether fire can spread or whether explosions damage blocks.

The values in flags.toml are the server-wide defaults. Island owners can toggle flags for their own island via /island flag.

In-game flag management

Island Lifecycle

Visiting

Members

Island Settings

Features

Commands

Supported databases

SkylliaBank supports the same databases as Skyllia: SQLite, MariaDB, and PostgreSQL. It uses the same connection pool.

Generator configuration

generator_default: "basic"  # generator assigned by default

generators:
  - name: "basic"
    replace_block:         # which blocks can be replaced
      - cobblestone
      - stone
    world:
      - sky-overworld
    block_chance:
      - block: cobblestone
        chance: 80.0
      - block: iron_ore
        chance: 15.0
      - block: diamond_ore
        chance: 5.0

  - name: "vip"   # better generator for VIP players
    replace_block:
      - cobblestone
    world:
      - sky-overworld
    block_chance:
      - block: cobblestone
        chance: 50.0
      - block: gold_ore
        chance: 25.0
      - block: diamond_ore
        chance: 15.0
      - block: emerald_ore
        chance: 10.0

Commands

Challenge file format

id: "skyllia:farmer_1"
name: "<yellow>Farmer I"
lore:
  - "Harvest 64 Wheat on your island."

requirements:         # conditions player must meet
  - "ITEM:WHEAT 64"    # player must have 64 wheat

rewards:             # what the player receives on completion
  - "ITEM:DIAMOND 3"   # 3 diamonds
  - "CMD:broadcast %player% completed Farmer I!"

maxTimes: -1        # -1 = unlimited completions
cooldown: "24h"      # must wait 24h before doing it again
broadcast: true     # announce completion server-wide
showInGui: true

gui:
  row: 2
  column: 5
  page: 1
item: "HAY_BLOCK"

Requirement types

Cooldown formats

Supported: 24h, 1d / 1day, 1w / 1week, 1m / 1month, 1y / 1year

Commands

Usage

Commands

Configure limits directly in the Insights plugin configuration — InsightsSkyllia automatically scopes those limits to individual islands rather than the entire server.

Maven / Gradle dependency

repositories {
    maven("https://repo.euphyllia.moe/repository/maven-public/")
}

dependencies {
    compileOnly("fr.euphyllia.skyllia:api:3.x")
}

Core API classes

import fr.euphyllia.skyllia.api.SkylliaAPI;
import fr.euphyllia.skyllia.api.skyblock.Island;
import org.bukkit.entity.Player;

// Get the island for a specific player
Island island = SkylliaAPI.getIslandByPlayerId(player.getUniqueId());

if (island != null) {
    double size = island.getIslandSize();
    player.sendMessage("Island size: " + size);
}

Events

Requires PlaceholderAPI installed on your server.