AeroWars - A SkyWars plugin

A competitive SkyWars-style minigame for Hytale.
Multi-arena Solo & Teams, spawn cages, chest loot tables, selectable kits, spectator mode, cosmetics, parties & matchmaking, and a fully custom UI/HUD.

💬 Join the community!
Have questions, ideas, or just want to chat? Join the Stoshe Labs Discord server:
discord.gg/rC9eSzH3tf

Overview

AeroWars drops each player (or team) onto a floating island. Grab loot from island and middle chests, gear up, and be the last one standing. Matches run in isolated, disposable worlds cloned from arena templates, so any number of games can run at once without touching your main world.

• Solo (FFA) and co-op Teams arenas, with configurable team size
• Spawn cages that hold players during the countdown, then shatter open on start
• Weighted chest loot (island / middle tiers) with a unified, scheduleable events system
• Selectable kits — pick before the match, or build them visually in the admin panel
• Spectator mode on death — fly around, teleport to living players, or head back to lobby
• Parties & matchmaking queues (solo/teams), with keep-together or auto-split behaviour
• Cosmetics — cage themes, kill effects, victory shows, movement trails
• Stats & leaderboards, economy rewards, PlaceholderAPI, and TaleGuard protection

Installation

1. Drop AeroWars-1.0.0.jar into your server's mods/ folder.
2. (Optional) Install PlaceholderAPI for %aerowars_...% placeholders.
3. (Optional) Install TaleGuard for full interaction protection.
4. Start the server once to generate the config, then configure and create your arenas.

Every command below is under /aerowars and also the shorter alias /sw.

Quick start (create your first arena)

1.  /sw world create skyisland        # make a void template world and build your map in it
2.  /sw setup start arena1 skyisland   # begin the setup wizard (teleports you in, hands the wand)
3.  (Step 1) left-click blocks to mark spawns  — or stand on a spot and use /sw setup set
        co-op arena?  /sw setup mode coop 2
4.  /sw setup done                     # Step 2/3: place NORMAL then MIDDLE chests (from Creative)
5.  /sw setup done                     # Step 4: stand at the spectator spot, /sw setup set
6.  /sw setup save                     # arena is saved and enters rotation

Lost the wand mid-setup? /sw wand. Editing later? /sw setup edit arena1. Clearing an arena's chests sends it to draft (hidden from matchmaking) until you add chests again.

Commands

Player commands

_{Open to everyone by default — permission aerowars.play (default: allowed).}

Admin commands

_{Require permission aerowars.admin (default: denied).}

Permissions

Only the everyday player commands are open by default; everything that changes server state (setup, world creation, admin panel, force-start, save-kit, set-lobby) is gated behind aerowars.admin.

Configuration

The config is generated at mods/Stoshe_AeroWars/config.json. Highlights:

Loot events (unified & randomizable)

Everything that changes chests mid-game — periodic refills and gradual loot upgrades — is one configurable list. Each entry has a Type (refill or loot_upgrade) and a Time (seconds into the match). Turn on Randomize to ignore the fixed times and instead fire the enabled events at random moments, in random order, spread across the match (never closer together than MinGapSeconds).

"Loot": {
  "FillOnStart": true,
  "Events": {
    "Enabled": true,
    "Randomize": false,
    "MinGapSeconds": 90,
    "List": [
      { "Type": "loot_upgrade", "Time": 300, "Enabled": true },
      { "Type": "refill",       "Time": 480, "Enabled": true },
      { "Type": "loot_upgrade", "Time": 660, "Enabled": true }
    ]
  }
}

Loot tables themselves live in mods/Stoshe_AeroWars/loot.json (tiers normal and middle) and are also editable from the admin panel's Loot tab.

Economy

AeroWars can pay coins on kill and win. It resolves an economy provider reflectively (no hard dependency), so it just works when a supported plugin is installed and stays inert otherwise.

• Primary: the sibling overworld economy (com.overworldlabs.economy)
• Fallbacks: EliteEssentials, Ecotale

"Rewards": {
  "Economy": { "Enabled": false, "WinAmount": 100, "KillAmount": 10 }
}

Set Enabled: true and pick your amounts. With no provider present, rewards are simply skipped (no errors).

PlaceholderAPI

With HelpChat PlaceholderAPI installed, AeroWars registers the aerowars expansion. Test with /papi list, /papi parse <player> <text>, or /papi bcparse <player> <text>.

TaleGuard protection

AeroWars enforces its own core rules through the server's ECS events — no extra plugin required. For the interaction surfaces the ECS events cannot intercept, it registers an optional protection hook with TaleGuard, the shared Mixin/transformer protection bridge.

In short: AeroWars is fully playable on its own, and installing TaleGuard closes the remaining interaction gaps (pickup, use, fluids, seats, tools, explosions, commands) inside AeroWars worlds and the lobby. TaleGuard is a soft dependency — if it isn't installed, AeroWars logs a note and runs with its built-in protection.

Localization

Ships with English (en_us) and Portuguese (pt_br). Set General.Language, or edit / add a file under mods/Stoshe_AeroWars/lang/.