AetherSky

AetherSky

AetherSky is a premium Skyblock & OneBlock engine for Paper 1.21.4+ (including 26.x). It generates its own void world, places every island on a fixed grid and ships with a full OneBlock phase system, co-op teams, island upgrades and a clean in-game dashboard.

This wiki is written for server owners and server developers/admins who install and configure the plugin.

Highlights

Feature	What it means for you
Two island modes	Players choose OneBlock (one regenerating block) or Classic Skyblock (a small island with a tree and a starter chest). You decide which modes are available.
Built-in void world	No world downloads or schematics. AetherSky creates a 100% empty void world (aether_islands) on the first start.
Grid island allocator	Every island gets its own cell on a spiral grid (default 1000 blocks apart). Islands can never overlap.
OneBlock phases	Plains → Underground → Nether → The End, fully configurable in phases.yml with weighted blocks, mobs and loot chests.
Co-op teams	Invite friends, promote/demote them and transfer leadership. Roles: Leader, Member, Visitor.
Island upgrades	Bigger border, faster crops, more mob spawns and a larger team. Paid with XP levels or Vault money.
Island level & border	Islands level up from OneBlock breaks and valuable blocks. The personal world border grows with the level.
Gameplay quality of life	Auto-pickup for OneBlock drops, stacked ground items with a 20x Item label and a separate island inventory.
Discord logging	Optional: post island events to Discord through AetherDiscord.
SQLite or MySQL	All data is cached in memory and saved asynchronously through HikariCP, so the main thread never waits for the database.

Pages

1. Installation
2. Commands & Permissions
3. Islands, Co-op & Protection
4. OneBlock Phases (phases.yml)
5. Island Upgrades
6. Auto-Pickup, Item Stacking & Separate Inventories
7. Configuration (config.yml)
8. Discord Integration
9. Storage & Performance
10. Troubleshooting & FAQ

Quick start

/is                         # open the dashboard (or the "Create Your Island" menu)
/is create oneblock         # create a OneBlock island
/is invite Steve            # invite a co-op member
/aethersky setphase Steve nether
/aethersky reload

Requirements

• Paper 1.21.4 or newer (26.x supported). Spigot is not supported.
• Java 21+ (Java 25 on 26.x servers)
• Optional: Vault + an economy plugin, to pay upgrades with money
• Optional: AetherDiscord, for Discord logging