AetherSky Islands

Islands, Co-op & Protection

The island world

AetherSky creates the world set in world.name (default aether_islands) with its own void generator. Every chunk is pure air: no terrain, caves, structures or generated mobs. The whole world uses one biome (world.biome, default plains).

You can also use the generator for other worlds, for example in bukkit.yml or with Multiverse, with the generator name AetherSky (or AetherSky:cherry_grove for a specific biome).

Island modes

Mode	What the player gets
OneBlock	A single block at oneblock.y (default 100). It regenerates every time it is broken. See [[OneBlock Phases
Classic Skyblock	A small, rounded floating island at classic.y: grass, dirt, a sand patch, an oak tree and a starter chest (classic.starter-chest).

Both are generated in code. Chunks are loaded asynchronously before the blocks are placed.

The grid

Islands are placed on a spiral grid around 0,0. With the default grid.spacing: 1000, the first islands are at 1000,0, 1000,1000, 0,1000, -1000,1000, and so on. grid.skip-origin: true keeps 0,0 free for an admin area.

Safety rules:

• A grid cell is never handed out twice, also not after an island was deleted.
• Before a new island is placed, AetherSky checks that the cell is empty in the world. A cell that still contains blocks (old islands, builds, a wiped database) is skipped and a line is logged: Grid cell 1,1 (index 2) still contains blocks - skipping it for the new island.
• The grid counter is stored in the database and in aether_islands/aethersky-grid.properties, so it survives a lost or replaced database.
• Do not change grid.spacing once islands exist. If you do, AetherSky keeps the old spacing and logs a warning, because islands would otherwise overlap.

Deleting an island

/is delete (typed twice) does the following:

1. Teleports everyone on the island to the lobby.
2. Wipes the whole island area: all blocks, chests, item frames, mobs and dropped items within the maximum border size. This is spread over several ticks, so there is no lag spike.
3. Removes the island, its members and pending invites from the database.

Roles & co-op

Role	Rights
Leader	Full control: invite, kick, promote/demote, transfer, delete, settings, upgrades.
Member	Co-op builder with full build access. Counts towards the team limit (TEAM_SIZE upgrade). Can buy upgrades if island.members-can-buy-upgrades: true.
Visitor	A trusted visitor. Can always enter the island, also when visitors are locked out, and follows the visitor settings below. Does not count towards the team limit and can still own an island of their own.

• A player can be Leader or Member of only one island.
• /is promote on a stranger makes them a trusted Visitor. Promoting a Visitor makes them a Member (only if they have no island of their own).
• Invites expire after island.invite-expire-seconds (default 120).

Island settings

Set by the leader in /is settings (members too if island.members-can-edit-settings: true). Defaults for new islands are in island.default-settings.

Setting	Default	Effect
PVP	off	Players can damage each other on this island.
VISITORS_ALLOWED	on	Other players can visit with /is visit (and with other teleport plugins).
VISITOR_INTERACT	off	Visitors can use doors, buttons, levers, pressure plates and animals.
VISITOR_CONTAINERS	off	Visitors can open chests, furnaces, barrels and other containers.
VISITOR_PICKUP	off	Visitors can pick up dropped items.

Protection

• Only the Leader and Members can break or place blocks, use buckets, break item frames or paintings and edit armor stands.
• Visitors and strangers follow the settings above. Hostile mobs can always be fought.
• Outside an island (empty grid cells) nobody can build, except players with aether.admin.bypass.
• Void rescue (island.void-rescue: true): players who fall into the void are teleported back to the island instead of dying.
• Respawn on island (island.respawn-on-island: true): players who die on an island respawn at their own island.

Island level & border

• Islands gain island XP from OneBlock breaks (oneblock.xp-per-block) and from placing valuable blocks (level.block-values). Breaking those blocks removes the XP again.
• XP needed for the next level = level.base-xp + level × level.xp-increment.
• Every player gets a personal world border around the island they stand on: border.base-size + level × border.per-level + BORDER_SIZE upgrade, capped at border.max-size.
• A level-up shows an Island Level Up title to all online members.