Chaos Arena

> ⚠️ EXPERIMENTAL — Disabled by default. API may change.

Chaos Arena — PvP arena with random hazards, round system, mutators, leaderboard, and multiple game modes.

Configuration

{
  "ChaosArena": {
    "Enabled": false,
    "HazardIntervalMs": 8000,
    "ArenaDefaultRadius": 20,
    "DefaultMode": "FreeForAll",
    "DefaultRounds": 3,
    "MutatorsEnabled": true,
    "RespawnDelayMs": 0,
    "MaxRespawns": -1,
    "KillFeedEnabled": true,
    "LeaderboardEnabled": true,
    "PointsPerKill": 10,
    "PointsPerRoundWin": 50,
    "PointsPerMatchWin": 100,
    "MinPlayersToStart": 2,
    "CountdownSeconds": 10,
    "SpectatorEnabled": true
  }
}

Match Modes

Mode	Description
FreeForAll	Last player standing wins
TeamDeathmatch	Red vs Blue, most kills wins
Rounds	Multiple rounds, points per round win
KingOfTheHill	Hold center zone for points
Survival	Waves of hazards, last alive wins

Mutators

Each round can get a random mutator that changes the rules:

Mutator	Effect
DoubleDamage	All hazards deal x2 damage
DoubleSpeed	Hazards spawn twice as fast
Fragile	Players have -50% health
NoHealing	No healing allowed
LowGravity	Higher jumps, slower falls
FogOfWar	Reduced visibility
SingleHazard	Only one hazard type all round
Haste	All players move faster
SuddenDeath	One hit kills
LootFrenzy	Random item drops

Hazards (14 types)

Hazard	Effect
Shockwave	Explosion from random player — knockback + damage
Lightning Strike	Telegraph → strike after 2s
Poison Zone	Toxic zone, 4 block radius, 8s, 3 DPS
Gravity Pull	All players pulled to center
Arena Shift	Arena shrinks 50%, outside = 5 DPS
Speed Boost	Random player +40% speed for 5s
Meteor Barrage	5-10 meteors across the arena
Floor Is Lava	Floor deals damage for 6s (jump!)
Blackout	All players blinded for 5s
Mob Wave	Hostile mobs spawn in arena
Item Drop	Beneficial item at random location
Freeze	Random player frozen for 3s
Teleport	All players teleported to random positions
Mirror Damage	5s — all damage reflected back

Custom Hazard Pools

Each arena can have its own hazard pool with weights for more/less frequent hazards.

Scoring & Leaderboard

Points

Kill: +10
Round Win: +50
Match Win: +100

Leaderboard

Persists across server restarts
Tracks: kills, deaths, wins, losses, matches, best streak, total score
Win rate calculated automatically

Rewards

Arenas can give items based on placement:

Winner gets specific items
Top N players can receive rewards
Configurable per arena

Commands

Command	Privilege	Description
`/chaosarena leave`	chat	Leave arena/spectator
`/chaosarena spectate`	chat	Watch nearest arena
`/chaosarena stats`	chat	Personal stats
`/chaosarena leaderboard`	chat	Top 10 players
`/chaosarena setmode <mode>`	admin	Change arena mode
`/chaosarena resetleaderboard`	admin	Reset leaderboard

Gameplay Flow

Place Chaos Arena block
Players right-click block to join
When MinPlayersToStart reached → countdown begins
Match starts → mutator announced
Hazards activate every 6-10 seconds
Kill feed announces kills
Last standing / highest score → winner
Results, leaderboard update, rewards given

Respawn

RespawnDelayMs > 0 → players respawn after delay
MaxRespawns limits respawn count
RespawnDelayMs = 0 → elimination (death = out)

Spectator Mode

/chaosarena spectate — watch without participating
Spectators see kill feed and results

Architecture

Zero load when idle (no ticks without active match)
Hazards via callback chain (not polling)
Damage zones via 500ms tick (auto-unregisters)
KOTH via 1s tick (only in KOTH mode)
Leaderboard saved on world save