AetherSky Configuration

Configuration (config.yml)

plugins/AetherSky/config.yml holds all settings and all player-facing messages. Run /aethersky reload after editing. OneBlock phases live in a separate file, see OneBlock Phases.

storage

Key	Default	Description
type	SQLITE	SQLITE or MYSQL.
sqlite.file	islands.db	SQLite file inside plugins/AetherSky/.
mysql.host / port / database	localhost / 3306 / aethersky	MySQL connection.
mysql.username / password	root / empty	MySQL credentials.
mysql.properties	useSSL=false&...	Extra JDBC URL parameters.
mysql.pool-size	8	Maximum connections in the pool.
autosave-seconds	60	How often changed islands (block counters, XP, progress) are written.

Changing the storage type needs a restart. See Storage & Performance.

world & grid

Key	Default	Description
world.name	aether_islands	Name of the void island world.
world.biome	plains	Biome of the whole island world (vanilla key, e.g. cherry_grove).
world.lobby-world	empty	World players are sent to after leaving/deleting. Empty = main world spawn.
grid.spacing	1000	Blocks between island centres. Never change once islands exist.
grid.skip-origin	true	Keep 0,0 free.

island

Key	Default	Description
modes	[ONEBLOCK, CLASSIC]	Island types players can choose.
default-mode	ONEBLOCK	Mode for /is create without a type.
invite-expire-seconds	120	Co-op invite lifetime.
delete-confirm-seconds	15	Time to type /is delete a second time.
void-rescue	true	Teleport players back instead of dying in the void.
respawn-on-island	true	Respawn at the island after dying on an island.
members-can-edit-settings	false	Members (not only the leader) can toggle island settings.
members-can-buy-upgrades	true	Members can buy upgrades.
default-settings.*	see [[Islands	AetherSky-Islands]]

classic & oneblock

Key	Default	Description
classic.y	100	Height of a Classic island.
classic.starter-chest	lava, ice, bone meal, ...	Items in the starter chest (MATERIAL:amount).
oneblock.y	100	Height of the OneBlock.
oneblock.xp-per-block	1.0	Island XP per OneBlock break.
oneblock.cycle-phases	true	Restart at phase 1 after the last phase.
oneblock.action-bar	Phase <phase_number>: ...	Action bar after every break. Placeholders: <phase_number>, <phase_name>, <progress>, <required>.

auto-pickup, item-stacking, separate-inventory

See Auto-Pickup, Item Stacking & Separate Inventories.

discord

See Discord Integration.

border

Key	Default	Description
enabled	true	Show a personal world border around the island a player stands on.
base-size	50	Border diameter at island level 0.
per-level	2	Extra diameter per island level.
max-size	400	Maximum diameter (also the area wiped on delete).
warning-distance	2	Red screen warning distance.

level

Key	Default	Description
base-xp	100	XP for level 0 → 1.
xp-increment	50	Extra XP needed for every next level.
default-value	0	Island XP for placing a block that is not listed.
block-values.*	iron/gold/diamond blocks, beacon, ...	Island XP for placing a block (removed again when broken).

upgrades

See Island Upgrades.

gui

Key	Description
filler	Material for the empty slots of every menu.
titles.main / create / members / upgrades / settings	Menu titles (MiniMessage).

messages

Every chat message, title and action bar is in messages. They use MiniMessage: colors (<red>, <#5EE7DF>), gradients (<gradient:#5EE7DF:#B490CA>), <bold>, and clickable text (<click:run_command:'/is accept'>).

• <prefix> inserts messages.prefix.
• Placeholders such as <player>, <level> or <phase_name> are filled in by the plugin. You can move or remove them, but do not rename them.
• Keep messages in English if you sell or share your setup; all defaults are English.