v1.2.0

AeroWars v1.2.0 — Hytale 0.6 support: prefab cages, spectators on Hytale's native spectator mode, every player-facing text translated, and a round of fixes.

⚠️ Requires Hytale 0.6

• This jar is AeroWars-1.2.0-hytale-0.6.jar and declares ServerVersion >=0.6.0 <0.7.0 — a server on another line refuses it at load instead of breaking mid-match.
• Still on Hytale 0.5? Stay on v1.1.0 (it does not work on 0.6). Update the plugin and the server together.
• The docs are now versioned per release line: https://stoshelabs.github.io/aerowars/ — 1.1 (Hytale 0.5) stays under v1.1 in the version menu.

⭐ Cages are now prefabs

• Every cage is a .prefab.json in the plugin's cages/ folder — capture one with Hytale's prefab tool and drop it in. The built-ins (glass, colours, rainbow) are generated on first run; existing installs are migrated automatically.
• Cages are placed through the engine's native prefab placement, so block ids, per-block rotations and the prefab anchor are reproduced exactly, and the anchor cell (your spawn) is kept clear.
• Per-arena default cage — /aerowars arena cage <arena> <cage>. Precedence at match start: the player's own cosmetic > the arena default > the default cage.
• Orientation — /aerowars cage face <cage> <north|east|south|west|off> sets a cage's front and turns it to face the middle chest at match start. Stored on the cage's cosmetic in cosmetics.json (rotation + faceMiddle).
• /aerowars cage list and /aerowars cage delete, a Cages tab in the admin panel, and a rotatable 3D preview in both the admin panel and the cosmetics shop.
• Note: the fixed-size prefab replaces the old cage that grew with team size — author a roomier cage prefab (or a per-arena default) for large teams.

👻 Native spectator mode

• Dead players and admin spectators now run on Hytale 0.6's spectator (Spectator.NativeMode, default on): flight and no-clip, invulnerable and intangible, hidden from living players and the player list (spectators still see each other), and on the spectator voice channel. The tracker and return-to-lobby tools still work.
• A spectator who disconnects mid-match is let out of the mode on their next login. Set NativeMode to false for the previous hand-rolled spectator state.

New

• Fall-damage grace window on the cage drop (Cages.FallImmunitySeconds, default 5).
• Kit persistence (Kits.PersistLastKit, default on) — your last-picked kit is remembered across matches.
• Waiting-phase hotbar (Kits.WaitingItems, default on) — a Kit Selector and a Return to Lobby item while you wait in your cage.
• Randomized starting islands (Match.RandomizeSpawns, default on).
• Translated winner announcement (Match.AnnounceWinner, default on) — "X won the match on Y" for everyone not in the match, in the server's language.
• Mod icon — shown in a world's Mods tab instead of "?".
• Update banner — printed at the very end of the boot log.

Changes & fixes

• Everything a player reads is translated. Command hints, the setup wizard, team names (always Portuguese before), admin panel labels and more now come from the language files. Kit item names use each item's own translation, so players read them in their client's language. The Portuguese translation drops leftover English ("jaula", "abates", "visualizar").
• Rewards.WinnerCommands is empty by default; the old hardcoded broadcast line is removed from existing configs automatically, so the winner isn't announced twice.
• Hotbar tools (kit selector, tracker, return-to-lobby) fire on both clicks, block-aimed or in open air.
• Kit picker reworked cosmetics-style: ownership filter, per-kit icons, status, an IN USE marker, and accurate empty states.
• Victory fireworks last the whole end celebration; Match.EndCelebrationSeconds now defaults to 15.
• Death — including fall and void deaths — reliably lands you at the spectator spawn.
• No more logging back in inside a deleted match world: you're rerouted to the lobby.
• Spectators can't break, place or use blocks, or pick up items.
• Fixed a crash in the disconnect handler when a player aborted the login.
• The optional TaleGuard dependency is declared as Stoshe:TaleGuard (the old id never matched).
• Removed the one-click "Clear chests" button from the admin panel.

Upgrading

• Replace the jar and restart the server — never hot-swap it.
• AeroWars exports lang/en_us.json and lang/pt_br.json once, and your copy overrides the bundled text. New keys appear automatically; delete (or merge) your copy to pick up reworded lines.

---

_{Requires a Hytale server in the >=0.6.0 <0.7.0 range. Optional companions: PlaceholderAPI and TaleGuard.}

v1.1.0

AeroWars v1.1.0 — maps become first-class, a batch of correctness fixes, and new admin quality-of-life commands.

⭐ Maps are now separate from arenas

• Map layout (spawns, chests, spawn cages, spectator spawn) is stored per map in maps/<template>.json instead of on the arena — so several arenas can share the same map.
• New map-first setup flow:
  • /aerowars setup start <template> — build the map (spawns / chests / spectator spawn).
  • /aerowars arena create <name> <map> <solo|teams> [teamSize] — create an arena over a configured map.
• Random map pool per arena, opt-in (off by default): /aerowars maps <arena> add <map> then /aerowars maps <arena> random on. Each match then clones a random map from the pool, and pool maps may have completely different layouts.
• setup mode was removed — mode and team size are now chosen at arena create.
• Existing arenas are migrated automatically on load: their inline layout is lifted into a map file, so nothing to redo.

New commands

• /aerowars reload — reload config, language, loot, kits, maps and arenas without restarting the server.
• /aerowars forcestop — admin abort of the match you're in (the counterpart to /aerowars forcestart).
• /aerowars arena create | enable | disable | info — arena administration.
• /aerowars maps add | remove | list | random — manage an arena's map pool.
• Full tab-completion across the new commands (arena names, map names, and fixed choices).

Fixes

• Stats no longer lost on a crash — periodic auto-save (honoring AutoSaveIntervalSeconds) plus a flush at match end; previously stats were only written on a clean shutdown.
• Default kits now use valid item IDs, and kit armor is actually worn instead of dropped into the backpack (affected every kit, including paid ones).
• Editing config in-game no longer wipes the comments in config.json.
• Friendly-fire / self-hit checks now compare players correctly (they were comparing by reference).
• Thread-safety — match rosters and joins are now safe against the match tick (no more rare mid-tick errors), and simultaneous joins can't overfill an arena.
• Paid kits / cosmetics no longer dead-end on deposit-only economy providers — they fall back to free when the economy can't charge.
• A teams match can no longer start with a single team (it would otherwise idle out the full duration).
• Games-played is now counted at match start rather than on join, so aborted or cancelled joins no longer inflate stats.
• Removed a stray diagnostic log that spammed on every projectile, a raw stack trace, and a possible crash when a player fell into the void mid-teleport.

Changed / removed

• The unused HUD toggle and the dead MatchHud / StatusHud were removed — the scoreboard and on-screen titles already cover everything. The Hud config block is gone.
• Effects (fireworks / podium) is now documented in config.json.
• The countdown shortens to 5s when an arena fills up (early start).
• The aerowars.play permission is now enforced on join and queue.

Added

• Changelog popup (admin) — on joining after an update, admins get a modal with the latest release notes (pulled from GitHub), with Close and Don't show until next version. Re-open any time with /aerowars changelog.

---

_{Requires a Hytale server. Optional companions: PlaceholderAPI and TaleGuard.}

v1.0.0

AeroWars v1.0.0

Initial public release.

A competitive SkyWars-style minigame for Hytale, featuring Solo and Teams arenas with spawn cages, chest loot, selectable kits, spectator mode, parties, cosmetics, and a fully custom UI.

---

Gameplay

• Solo (FFA) and co-op Teams arenas, with configurable team size
• Isolated, disposable match worlds cloned from arena templates, so many games run at once
• Spawn cages hold players during the countdown, then shatter open on start
• Configurable countdown, match duration, end-celebration, and min players
• Win / draw / time-up resolution, with a victory podium and firework show

Arenas and setup

• In-game setup wizard: /aerowars setup start <arena> <template>
• Mark spawns with the setup wand or /aerowars setup set; place NORMAL and MIDDLE chests
• Co-op arenas via /aerowars setup mode coop <size>
• Re-edit any arena with /aerowars setup edit; recover the wand with /aerowars wand
• Clearing an arena's chests sends it to draft (hidden from matchmaking) until chests are added
• Arenas in use by a live match cannot be edited or deleted
• Create void template worlds to build maps in with /aerowars world create <name>

Loot and events

• Weighted chest loot with island (normal) and middle tiers, editable in the admin panel
• Unified, schedulable in-match events (chest refill and gradual loot upgrade)
• Randomize mode fires events at random moments, in random order, spread across the match

Kits

• Selectable kits with an in-game picker showing real item icons
• Visual kit builder in the admin panel: click inventory items (all sections) to copy them into a kit
• Free, permission-locked, and purchasable kits

Spectator mode

• Dead players become spectators: flight, invulnerable, and invisible to living players
• Hotbar tools: a tracker to teleport to living players, and a bed to return to the lobby
• Full inventory save and restore on match entry and exit

Parties and matchmaking

• Party system with invite / accept / kick / promote / disband and a management menu
• Solo and Teams matchmaking queues
• Keep-together option (never split the party) or auto-split, with clear feedback when no arena fits

Cosmetics

• Cage themes (including a random Rainbow cage), kill effects, victory shows, and movement trails
• Free, permission-locked, and purchasable, browsable in the cosmetics shop

Stats, economy, and integrations

• Stats and leaderboards (kills / wins), with optional SQL persistence (SQLite / MySQL / MariaDB / Postgres)
• Optional economy rewards on kill and win (resolves a provider reflectively; no hard dependency)
• PlaceholderAPI expansion (aerowars) exposing arena, queue, party, player, and leaderboard placeholders
• TaleGuard protection hook for the interaction rules the ECS events cannot cover (soft dependency)

Interface and admin

• Custom scoreboard and event HUD, on-screen titles, and a chat prefix you fully control
• Full admin panel: arenas, loot tables, live matches, kits, and settings toggles
• Update checker (terminal, admin chat on join, and the admin panel)

Localization

• Ships with English (en_us) and Portuguese (pt_br)