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 uxmSkyblock; 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 |
nether & end¶
nether:
enabled: true
world-name: islands_nether
island-height: 64
schematic: nether.schem
home-offset:
x: 6.5
y: 3.0
z: 6.5
yaw: 0.0
end:
enabled: true
world-name: islands_the_end
island-height: 64
schematic: end.schem
home-offset:
x: 7.5
y: 4.0
z: 10.5
yaw: 180.0
Every island gets its own Nether and End plot, placed at the same grid cell as the overworld island but in dedicated void worlds. Players reach them with real portals โ light the Nether portal in your Nether plot to dive in, then step through the ready-made End portal that waits there to reach your End plot.
| Key | Meaning |
|---|---|
enabled |
Turn the dimension on/off |
world-name |
The dedicated void world for that dimension |
island-height |
Y level the plot is built at |
schematic |
.schem file pasted for the starter plot (in plugins/uxmSkyblock/schematics/). Leave blank to use the built-in block-by-block builder instead |
home-offset |
Where the player lands relative to the plot, with facing yaw |
Where the plots live
The plots are built the first time a player travels there and live on the
same backend server as the island, so this works on a proxy network with no
extra setup. The bundled nether.schem / end.schem are extracted to the
schematics folder automatically and can be replaced with your own builds.
No FastAsyncWorldEdit?
If FAWE is missing, the plots fall back to a built-in builder that lays the same layout block-by-block, so portals still work.
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
icon: GRASS_BLOCK
home-offset: { x: 10.5, y: 11.0, z: 10.5 }
desert:
display-name: "&eDesert"
file: desert.schem
icon: SAND
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.
| Key | Meaning |
|---|---|
display-name |
Name shown in the type-selection menu |
file |
The .schem file in plugins/uxmSkyblock/schematics/ |
icon |
Material shown for this type in the selection menu |
home-offset |
Where the player lands on the pasted island |
When a player runs /is create with no type, a selection menu lists every
entry here as its own icon โ see Island Type menu. Add a
new entry and it appears in the menu automatically.
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.