Match Flow
Every match runs in its own disposable world cloned from the map's template, then goes through a fixed lifecycle. Most timings are configurable in the Match and Effects config sections.
Lifecycle
- Waiting — players join (directly, via queue, or as a party). The match waits until
Match.MinPlayersare present. - Countdown — a
Match.CountdownSecondstimer runs. Players sit in spawn cages and can pick a kit. The countdown shortens to 5 seconds when the arena fills up. - Start grace — a brief
Match.StartGraceSecondsdelay as cages open and the world settles. - Active — combat is live. Loot your island and the middle, then fight. The match caps at
Match.MaxDurationSeconds. - Ending — once resolved, a
Match.EndCelebrationSecondscelebration plays: the victory podium rises and fireworks fire. - Cleanup — the world is torn down and players return to the lobby.
Spawn cages
While the countdown runs, each player (or team) is enclosed in a cage so nobody can move or fight early. On start the cages shatter open. Cages are configurable in the Cages section — block type (with 12 colored glass variants), radius, and height — and they scale up for larger teams.
The void
Falling below the arena is fatal. When a player drops into the void they're eliminated — including the very last player, who is routed cleanly into spectator mode rather than falling forever.
Winning, draws & time-up
- Last team standing wins.
- If the clock runs out with exactly one team alive, that team wins; otherwise the match ends as a draw / time-up with no winner.
- Winners are made briefly invulnerable during the celebration so nothing can spoil the podium.
Victory
On a win, AeroWars can:
- Raise the winner(s) onto a podium above the arena center (
Effects.PodiumEnabled). - Play a firework show from the arena center (
Effects.VictoryFireworks), with configurable burst count, height, scale, and particle set. - Run any
Rewards.WinnerCommandsand pay out economy rewards.
Death & spectating
When a player dies (and Match.SpectateOnDeath is on) they become a spectator — flying, invulnerable, and invisible to the living. See Spectating.