config.yml
config.yml is the master settings file: world, commands, storage, proxy, warps,
generators, and more. This page walks through every section.
Updates merge automatically
New keys from a plugin update are added to your existing file on load, so upgrading never wipes your edited values.
island¶
| Key | Meaning |
|---|---|
enabled |
Master switch for the island system. Set false on a server that should run only a module (e.g. a pure Chunklock server): the /island command, island listeners and the island world stay off, but core managers (economy, block values, storage, proxy, module loader) keep running. |
clear-inventory-on-leave |
Clear a member's inventory when they leave or are kicked, so they can't carry off island loot. |
world¶
world:
name: islands
generator: void # void | normal
island-height: 100
island-distance: 250
island-size: 100
| Key | Meaning |
|---|---|
name |
Island world name |
generator |
void = classic empty Skyblock; normal = real terrain (required by Chunklock) |
island-height |
Y level islands are built at |
island-distance |
Spacing between island grid cells |
island-size |
Default protected size when the size upgrade isn't present |
border¶
A per-player world border drawn when entering an island.
Disable for Chunklock
When the Chunklock module manages its own border, set border.enabled: false
to avoid two WorldBorders fighting.
spawn¶
Where players go after their island is deleted (and on spawn return). Leave
world empty to use the main world spawn. Quick way to set it: stand somewhere and
run /is anaspawn. On a proxy network this can be overridden by proxy.spawn-server.
creation¶
How many islands may be built at once, and how many worker threads do it.
command¶
The command name, aliases, and every sub-command word are configurable here. See Commands Overview for the full list.
command:
name: island
aliases: [is, sb, ada, sky]
subcommands:
git: ["home", "go", "tp", "git", "ฤฑลฤฑnlan"]
olustur: ["create", "oluลtur", "olustur", "kur"]
# ... one entry per sub-command
invite-expire-seconds: 120
The left key is the internal name; the list is what players may type. There is
no command in plugin.yml โ they're registered dynamically.
warp¶
warp:
sign-tag: "[warp]"
sign-display: "&9[Warp]"
default-limit: 1
permission-prefix: "skyblock.warps"
See Warps for sign tags and per-rank limits.
economy¶
When enabled (and Vault is present), upgrades charge required-money. With Vault
missing or this set to false, only the level requirement applies.
obsidian¶
Right-click obsidian with an empty bucket to recover the lava. See Generators.
top¶
top:
chat-lines: 10
hologram:
lines: 10
height: 2.8
refresh-ticks: 40
title: "&6&lTOP ISLANDS"
entry: "&7{rank}. &f{owner} &8- &a{level} &7({points})"
empty: "&7No islands yet."
Leaderboard and the following hologram โ see Leaderboard.
schematics¶
schematics:
default: classic
list:
classic:
display-name: "&aClassic"
file: classic.schem
home-offset: { x: 10.5, y: 11.0, z: 10.5 }
desert:
display-name: "&eDesert"
file: desert.schem
home-offset: { x: 0.5, y: 5.0, z: 0.5 }
The island types offered by /is create [type]. Each points to a .schem file
(used on void worlds via FastAsyncWorldEdit) and a home offset.
storage¶
storage:
type: sqlite # sqlite | mysql
mysql:
host: localhost
port: 3306
database: skyblock
username: root
password: ""
ssl: false
See Database.
proxy¶
Cross-server sync. Disabled by default. See the dedicated Cross-Server Setup page for the full breakdown.