AetherSky Troubleshooting

Troubleshooting & FAQ

/is says "Island data is still loading"

Islands are loaded asynchronously right after startup. This normally takes less than a second. If it stays like this, look for Failed to load island data in the console; usually the database is unreachable (MySQL credentials, host or firewall).

The plugin disables itself on startup

Could not connect to the database - disabling AetherSky. Check the storage section. For MySQL, make sure the database exists and the user has rights on it.

New islands appear on an old island / where an island used to be

Since 1.2.1 this cannot happen anymore:

• /is delete wipes the whole island area.
• A new island is never placed in a grid cell that still contains blocks.
• The grid counter is also kept in aether_islands/aethersky-grid.properties.

Islands deleted with an older version left their blocks in the world. Those cells are skipped automatically; remove the leftovers with WorldEdit if you want.

Never delete the whole plugins/AetherSky/ folder to regenerate the config, and never change grid.spacing after islands exist.

New config options are missing after an update

Existing files are never overwritten. Copy the new sections from the default config.yml inside the jar, or rename your config.yml, restart, and copy your changes into the fresh file. See Installation.

A phase block from phases.yml never shows up

Check the console after /aethersky reload for unknown block '...' skipped. Use the exact Bukkit Material name. Blocks that do not exist on your Minecraft version are skipped too.

Upgrades cost XP although I set currency: VAULT

Vault and an economy plugin (for example EssentialsX Economy or AetherEco) must be installed. Otherwise AetherSky logs using XP levels and falls back.

My items are gone when I go to spawn!

They are not gone: AetherSky keeps a separate Island Inventory and Normal Inventory. Go back to your island and your island items are there. Turn this off with separate-inventory.enabled: false, or give trusted staff aether.inventory.bypass.

Players can't build on their friend's island

They need to be a Member (/is invite + /is accept). A Visitor (trusted) can enter but not build.

Visitors can't open doors or chests

That is the default. Enable VISITOR_INTERACT / VISITOR_CONTAINERS in /is settings, or change island.default-settings for new islands.

Nothing arrives in Discord

1. Is AetherDiscord installed? /aethersky discordtest tells you.
2. Does discord.channel match a key in AetherDiscord's webhooks / channels?
3. Is the event enabled in discord.events.<event>.enabled? (upgrade-purchased is off by default.)

Is Folia supported?

No. AetherSky supports Paper 1.21.4+ and 26.x.

Which Minecraft versions are supported?

Paper 1.21.4 up to 26.x with one jar. 1.21.0 - 1.21.3 are not supported because of API changes in 1.21.3 (biome and sound registries).