AetherSkyWars Plugin | SkyWars Minigame 2.0.1

📋 Overview

AetherSkyWars is a complete SkyWars minigame. Build as many arenas as you like, solo or teams, either generated by the plugin or pasted from your own schematics. Players pick a map from a menu or a sign, vote on chest tier, time of day and projectiles, and fight it out until one player or team is left.

Everything around the match is built in too: kits, a coin shop, cosmetics, parties, friends, quests, challenges, a mystery box, achievements and leaderboards.

AetherSkyWars is a fork of RealSkywars by José Rodrigues (MIT licence), rebuilt for 1.21.11 and newer on plain Bukkit API, with no version adapters or packet hacks.

🧩 Dependencies

• WorldEdit or FastAsyncWorldEdit (required) used to save, paste and reset arenas. Get FAWE here
• PlaceholderAPI (optional) placeholders for scoreboards, tab and holograms. Get it here
• DecentHolograms (optional) holograms for leaderboards and the lobby. Get it here
• Multiverse-Core, My_Worlds, RealRegions (optional) hooked when present

Most libraries are downloaded on first start instead of bundled, so let that first start reach the internet.

🗺️ Arenas

• Solo and teams, any player count and team size
• Default or schematic arenas. Let the plugin generate a world, or drop a .schem into the maps folder and it pastes it for you
• GUI setup. /asw create opens a settings menu, then hotbar items mark island chests, middle chests and cages
• Arenas reset themselves after every match from a saved backup
• Join signs with [asw] on the first line and the map name on the second

🗳️ Voting

Players vote before each match on three things, each gated by its own permission so you can make votes a rank perk:

• Chest tier: Basic, Normal or Epic, each with its own configurable loot
• Time: Day, Sunset or Night
• Projectiles: normal or block-breaking

✨ Cosmetics & Shop

Players earn coins and spend them in the shop on kits and cosmetics: cage blocks, bow trails, win blocks, kill effects, win effects, victory dances and cage balloons. Everything sold in the shop is configurable.

🎁 More to Play For

• Quests and challenges for players to work through between matches
• A mystery box you place in the lobby, with configurable rewards
• Achievements and leaderboards, with a hologram board topped by the leader's head
• A ranked system you can switch on or off
• Game history logged for every match

👥 Parties & Friends

Parties are built in, so groups queue together without another plugin. Invites expire on their own, and a party never changes who you can hit in a solo match.

Players can add friends, see how long they have been friends, and send private messages with their own choice of who can reach them. Shift right click any player for a card showing their stats, cosmetics and quick friend and party buttons.

⌨️ Commands

Main command /aetherskywars (aliases /asw, /as, /askywars, /sw, /rsw). Run /asw help in game for the full list.

Players

• /asw list open the maps menu
• /asw kits and /asw shop open the kits and shop menus
• /asw coins check your balance
• /asw lobby and /asw leave go to the lobby or leave a match
• /party create | invite | accept | leave | kick | disband manage your party

Staff

• /asw create <name> <type> <players> create an arena and open setup
• /asw setspectator and /asw finish set the spectator point and save the arena
• /asw edit, /asw register, /asw unregister, /asw delete manage arenas
• /asw forcestart start the current match now
• /asw setlobby and /asw reload

🔐 Permissions

• asw.admin every admin and setup command
• asw.SWKit the default kits
• asw.basic, asw.normal, asw.epic vote for a chest tier
• asw.day, asw.sunset, asw.night vote for the time
• asw.normal-projectile, asw.break-projectile vote for projectiles

🎛️ Fully Configurable

• Every message is editable, with hex, gradient and rainbow colours
• Menus, the shop, chest loot, the mystery box and leaderboard layouts all live in their own files
• Tab list customisation built in
• Config files update themselves on new builds, keeping your own edits
• Six languages ship with the plugin

💾 Storage

SQLite out of the box with no setup, or MySQL, MariaDB and other JDBC databases.

🔌 Developer API

Addons compile against the aetherskywars-api module, which exposes the maps, players, kits, shop, parties, leaderboards and the rest through AetherSkyWarsAPI.

🧪 Requirements

• Minecraft: 1.21.11 or newer, including 26.x
• Server software: Spigot, Paper or Purpur
• Java: 21 or newer
• Required: WorldEdit or FastAsyncWorldEdit

💬 Support & Docs

Full setup and configuration guides are in the documentation. Need help, found a bug, or want to suggest a feature? Join the Discord.