The modern
Skyblock engine

Step-by-step

Optional Plugins

Minimum config changes

Skyllia works out of the box with SQLite. The only values you typically want to customise immediately are island spacing and the database backend for production servers.

# Distance between islands (in regions — 1 region = 512×512 blocks)
[settings.island]
region-distance = 10        # 5120 blocks between island centres
max-islands    = 500_000

# Default: SQLite — no extra setup needed
[sqlite]
enabled = true

# Default island type used by /island create (no type arg)
[default-island]
default-schem-key = "my_first_island"

[island.my_first_island]
id          = "my_first_island"
size        = 50.0   # radius in blocks
max-members = 6

First steps in-game

config-version = 4
verbose        = false   # enable detailed console logging

[settings.island]
region-distance             = 10       # spacing in regions (1 = 512 blocks)
max-islands                 = 500_000
teleport-outside-island     = false   # auto-tp player if they fall below world min-y
restrict-player-movement    = false   # push players back if they leave their island boundary
enable-obsidian-to-lava-conversion = true  # right-click obsidian with bucket → lava bucket

[settings.island.delete]
prevent-deletion-if-has-members = true
chunk-perimeter-island          = false  # true = delete only island chunks (faster but less clean)

[settings.island.chunk-processing.delete]
threads   = -1    # -1 = auto (max(4, cpu_cores / 8))
delay-ms  = 50    # ms between chunk deletions (50 = 1 chunk/tick)

[settings.island.chunk-processing.biome]
threads   = -1
delay-ms  = 50

[settings.island.invitation]
teleport-when-accepting = true

[settings.island.queue]
allow-bypass = true   # permit 'skyllia.island.bypass.queue' permission

[settings.spawn]
enable     = true
world-name = "world"
block-x    = 0.0
block-y    = 0.0
block-z    = 0.0
yaw        = 0.0
pitch      = 0.0

[debug]
permission = false   # log missing permissions to console (useful for admins)

[settings.cache.ttl]
# -1 = never expire, 0 = disabled
warps       = -1
name-role   = -1
role        = -1
island      = -1
player-link = -1
members     = -1
state       = -1

[permissions]
check-owner = false   # if true, OWNER role is also subject to permission checks
check-ban   = false   # if true, banned players are denied island actions

Each block under [island.<key>] defines one island type players can choose with /island create <key>. The key must match the schematic name (or your external config ID).

# Which type is used when /island create is called without a type argument
[default-island]
default-schem-key = "my_first_island"

[island.my_first_island]
id          = "my_first_island"
size        = 50.0    # radius in blocks from the island centre
max-members = 6

[island.my_second_island]
id          = "my_second_island"
size        = 50.0
max-members = 6

[island.my_third_island]
id          = "my_third_island"
size        = 50.0
max-members = 6

Admin commands for island sizes

# Suppress warning if Nether/End are enabled in server but portals are disabled here
suppress-warning-nether-end = false

[worlds.sky-overworld]
environment  = "NORMAL"
portal-nether = "sky-nether"
portal-end   = "sky-end"
generator    = "default"
biome-id     = "minecraft:plains"
# Optional: "ocean" generator needs these two:
# sea-height = 63.0
# sea-block  = "WATER"
# Optional: custom world height
# min-y          = -64
# height         = 384
# logical-height = 384

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

[worlds.sky-end]
environment  = "THE_END"
portal-nether = "sky-nether"
portal-end   = "sky-overworld"
generator    = "default"
biome-id     = "minecraft:end_highlands"

SQLite (default)

[sqlite]
enabled = true
# Database file is placed automatically in plugins/Skyllia/

MariaDB

[mariadb]
enabled  = true
host     = "localhost"
port     = 3306
database = "skyllia"
username = "root"
password = "password"

[mariadb.pool]
maximum-pool-size  = 10
minimum-idle       = 5
connection-timeout = 30000
idle-timeout       = 600000
max-lifetime       = 1800000

PostgreSQL

[postgresql]
enabled  = true
host     = "localhost"
port     = 5432
database = "skyllia"
username = "postgres"
password = "password"

[postgresql.pool]
maximum-pool-size  = 10
minimum-idle       = 5
connection-timeout = 30000
idle-timeout       = 600000
max-lifetime       = 1800000

[player.island.leave]
clear-inventory  = true   # clear inv when leaving the island (not the server)
clear-enderchest = true
clear-experience = true

[player.island.kicked]
clear-inventory  = false
clear-enderchest = false
clear-experience = false

[player.island.delete]
clear-inventory  = true
clear-enderchest = true
clear-experience = true

[player.join.teleport]
own-island       = true    # teleport player to their island on server join
spawn-not-island = false   # teleport to spawn if player has no island

[player.permissions]
allow-teleportation = true

Teleport on Join

Setting own-island = true under [player.join.teleport] makes every player teleport directly to their island's home point when they join the server. If spawn-not-island = true is also enabled, players without an island are sent to the global spawn instead of the default server spawn.

Skyllia supports two schematic backends:

Each island type is configured per world. The key format is "<island_id>.<world_name>". You need one block per island type × world combination.

# island: my_first_island | world: sky-overworld
["my_first_island.sky-overworld"]
schematic        = "./schematics/default.schem"   # path to the .schem file
height           = 64.0                           # Y level where the schematic is placed
ignore-air-blocks = true                          # don't place air blocks (preserves existing terrain)
copy-entities    = true                           # copy entities from the schematic (cows, etc.)
plugin           = "WorldEdit"                    # "WorldEdit", "FastAsyncWorldEdit", or "Internal"
# Optional: restrict build height for this island type
# min-build-height = 0
# max-build-height = 150

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

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

# Repeat for each island type (my_second_island, my_third_island…)

Configuration reference

Role hierarchy rules

A player can only promote or demote players with a role strictly below their own. An OWNER cannot be demoted by anyone. Ownership can be transferred with /island transfer <player> (or /isadmin forcetransfer).

Managing roles in-game

Permissions control what actions each role can perform on an island. These are the server-wide defaults for all new islands. Players with the right role can further toggle permissions in-game via /island permission.

Available permissions

Default permission matrix

In-game permission management

Flags are passive environmental toggles — they control automatic/environmental behaviour on an island with no player context. They are NOT player permissions. Island owners can toggle flags in-game via the flag GUI (requires the skyllia:command.island.gamerule permission).

Per-world and per-island-type overrides

# Global defaults
[defaults]
"skyllia:island.allow.fire"       = false
"skyllia:island.allow.explosions"  = false
"skyllia:island.allow.fluids"      = true

# Override for a specific world (uncomment to use)
# [worlds.sky-nether.defaults]
# "skyllia:island.allow.explosions" = true
# "skyllia:island.allow.fire"       = true

# Override for a specific island type (uncomment to use)
# [island.my_first_island.defaults]
# "skyllia:island.allow.fluids" = false

In-game flag management

Island Lifecycle

Visiting

Members

Island Settings

Operating Modes

Features

• Shared island bank balance with deposit & withdrawal (automatic rollback on failure)
• Per-island deposit/withdraw permission gating via Skyllia's role system
• Paginated leaderboard (/is bank top) and rank display (/is bank rank)
• Admin commands for balance management
• PlaceholderAPI integration with async-refreshed cache
• SQLite, MariaDB, PostgreSQL — shared with Skyllia's connection pool
• Folia compatible

Configuration

[bank-account]
format   = "#,##0.##"   # Java DecimalFormat pattern
locale   = "fr_FR"       # e.g. "en_US" for 1,234.56 — "fr_FR" for 1 234,56
reset-on-island-delete = false

[cache]
ttl     = 60    # balance cache TTL in seconds (PAPI only)
ttl-top = 300   # leaderboard cache TTL in seconds

[vault]
enable-island-economy    = false  # true = SkylliaBank becomes the Vault provider
currency-name-singular   = "Coin"
currency-name-plural     = "Coins"
fractional-digits        = -1    # -1 = no rounding

Player Commands

Admin Commands

Island Permission Nodes

PlaceholderAPI

Identifier: skybank

SkylliaOre intercepts cobblestone generator events and replaces the generated block with a weighted random selection from your configured ore table. Each island can be assigned a different generator tier.

Generator configuration

generator_default: "basic"   # generator assigned by default to new islands

generators:
  - name: "basic"
    replace_block:   # which blocks the generator replaces
      - 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"
    replace_block:
      - cobblestone
    world:
      - sky-overworld
    block_chance:
      - block: cobblestone
        chance: 50.0
      - block: gold_ore
        chance: 25.0
      - block: "oraxen:custom_ore"   # Oraxen custom block
        chance: 15.0
      - block: "nexo:custom_ore"    # Nexo custom block
        chance: 10.0

Custom blocks from Oraxen or Nexo are supported with the oraxen: or nexo: prefix.

Commands

PlaceholderAPI

Identifier: skyore

SkylliaChallenge lets you define custom challenges that players can complete for rewards. Each challenge is a single .yml file in the challenges/ folder. Challenges can have multiple completion modes, cooldowns, and custom GUI positions.

Challenge file format

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

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

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

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

gui:
  row: 2
  column: 5
  page: 1
  item: "HAY_BLOCK"               # use "oraxen:id" or "nexo:id" for custom items
  amount: 1

Requirement types

Reward types

Cooldown formats

Cooldowns use a simple duration notation: 24h, 7d, 30m, 1h30m. Set to 0 or omit to disable cooldown.

Commands

SkylliaChat adds a private island chat channel. When a player toggles island chat on, all their messages are only visible to members of their island. Perfect for team coordination without cluttering global chat.

Usage

SkylliaChest provides a virtual shared chest that every island member can open from anywhere on the island. Items placed in it are accessible to all members based on their island permissions.

Commands

SkylliaInsights bridges the Insights plugin with Skyllia. It registers each island as an Insights region, so every limit rule you define in Insights is automatically scoped to individual islands. The addon identifier to use in Insights configurations is skyllia (Skyllia's plugin name, lowercased).

Example limit configurations

limit:
  type: "GROUP"
  bypass-permission: "insights.bypass.limit.redstone"
  name: "Redstone"
  limit: 64
  settings:
    enabled-addons:
      whitelist: true   # only apply inside Skyllia islands
      addons:
        - "skyllia"
  materials:
    - "REDSTONE_WIRE"
    - "HOPPER"
    - "DISPENSER"
    - "COMPARATOR"

limit:
  type: "TILE"
  bypass-permission: "insights.bypass.limit.tile"
  name: "Tiles"
  limit: 256

Configuration reference

SkylliaExtra bundles quality-of-life features too lightweight for their own addon. Currently it lets players set a custom name and description for their island, with full MiniMessage formatting support and PlaceholderAPI integration.

Player Commands

Using these commands also requires the matching island-level permission (set_name / set_description).

Admin Commands

PlaceholderAPI

Identifier: skylliaextra

If no custom name is set, %skylliaextra_name% falls back to <PlayerName>'s Island. Description placeholders return an empty string if not set.

SkylliaBackup packages the Minecraft region files (.mca) covering an island into a timestamped ZIP archive. Backups can be triggered by players (subject to cooldown) or by admins. Old backups are automatically pruned.

How it works

1. All Skyllia worlds for the island are retrieved.
2. Region files covering the island footprint are collected from each world's region/ folder.
3. A ZIP archive is created: <folder>/<islandId>/backup_<owner>_<trigger>_<timestamp>.zip
4. Backups beyond max-per-island are deleted (oldest first).
5. If an upload URL is configured, the ZIP is uploaded asynchronously via multipart HTTP POST.

Configuration

[backup]
folder                  = "plugins/SkylliaBackup/backups"  # or an absolute path, e.g. /mnt/nas/backups
max-per-island          = 5       # 0 = unlimited
allow-player-backup     = true
player-cooldown-seconds = 3600   # 0 = no cooldown

[upload]
url   = ""   # empty = disabled; example: "http://my-server:3000/upload"
token = ""   # Bearer token for Authorization header

Commands

SkylliaIslandValue periodically scans each island, assigns a configurable point value to every block type, computes a raw score, then converts it into a level using a customisable mathematical formula. Scores are stored in Skyllia's persistent data — no external database required.

How it works

1. Every N seconds (default 300 s), online players' islands are retrieved.
2. All chunks covered by the island are scanned block by block.
3. Each block count is multiplied by its configured value → raw score.
4. The level formula is applied → calculated level.
5. Score and level are saved to Skyllia's PersistentData (skylliaislandlevel:data).

Configuration

[island-level]
level-expression             = "FLOOR(SQRT(score / 100))"
min-level                    = 0
timer-interval-seconds       = 300   # scan cycle interval
timer-interval-seconds-top   = 300   # leaderboard refresh interval

[blocks]
# Point value per block type (use Minecraft material names)
DIAMOND_BLOCK  = 500
EMERALD_BLOCK  = 400
GOLD_BLOCK     = 200
IRON_BLOCK     = 100
DIAMOND_ORE    = 80
NETHERITE_BLOCK = 2000
BEACON         = 1000

Commands

PlaceholderAPI

Identifier: islandlevel

Maven / Gradle dependency

repositories {
    maven("https://repo.euphyllia.moe/repository/maven-public/")
}
dependencies {
    compileOnly("fr.euphyllia.skyllia:api:3.x")
}

<repository>
    <id>euphyllia-repo</id>
    <url>https://repo.euphyllia.moe/repository/maven-public/</url>
</repository>

<dependency>
    <groupId>fr.euphyllia.skyllia</groupId>
    <artifactId>api</artifactId>
    <version>3.x</version>
    <scope>provided</scope>
</dependency>

Core API classes

Usage example

// Get a player's island
Island island = SkylliaAPI.getIslandByPlayerId(player.getUniqueId());
if (island != null) {
    player.sendMessage("Your island size: " + island.getSize());
}

// Check a flag on the island
boolean allowFire = island.getFlag("skyllia:island.allow.fire");

// Listen to Skyllia events
@EventHandler
public void onIslandCreate(IslandCreateEvent event) {
    Island island = event.getIsland();
    // ...
}

Events

Core plugin placeholders

Identifier: skyllia

Addon placeholders summary