Arenas

In AdvancedFFA, every arena is an independent, fully configurable battleground with its own cuboid boundary, spawn coordinates, spectator spawn, player capacity, and reset scheduler.

---

Arena Setup Checklist

Before an arena can accept players (allowQueue true), all of the following requirements must be met:

1. Corner 1: Minimum cuboid coordinate
2. Corner 2: Maximum cuboid coordinate
3. Spawn Location: Spawn point for joining/respawning players
4. Spectator Location: Safe observation point for spectators
5. Linked Kit: Paired kit providing the combat loadout

You can quickly view all your arenas anytime:

/ffa arena list
# Output: Arenas(3): desert, nether, colosseum

---

Configuring Boundaries & Spawns

1. Set Boundaries

The cuboid boundaries define the playable area and FAWE block restoration zone:

# Stand at corner 1
/ffa arena edit <arena> setCorner1

# Stand at opposite corner 2
/ffa arena edit <arena> setCorner2

2. Set Spawns

# Stand where players should spawn
/ffa arena edit <arena> setSpawn

# Stand where spectators should spawn
/ffa arena edit <arena> setSpectator

---

Arena Restoration & Crash Protection

AdvancedFFA features a high-performance Delta Block Restoration Engine powered by FastAsyncWorldEdit (FAWE). Instead of freezing the server by pasting massive schematic files, AdvancedFFA tracks only the specific blocks modified during combat.

How It Works

1. Real-Time Delta Tracking
        │
        ▼
2. Smart Cycle Check
        │
        ▼
3. Broadcast Alerts
        │
        ▼
4. Instant Restoration

• Zero Schematics Required: You never need to capture, save, or manage bulky .schem files. Arena setup only requires defining your two corners and spawns.
• Auto-Skip Untouched Arenas: If no blocks were altered during the cycle, the reset is completely skipped—no alerts, no lag, and no combat interruption.
• Instant Admin Reset: Admins can restore an arena's modified blocks on demand anytime using /ffa arena reset <name>.

Custom Per-Arena Reset Interval

While config.yml sets the global default reset interval, admins can override the timer per arena. This is especially helpful if larger arenas need longer battles between resets:

# Set custom reset interval in minutes (e.g. 15 minutes)
/ffa arena edit desert resetInterval 15

# Revert to global default from config.yml
/ffa arena edit desert resetInterval default

Crash Recovery & Shutdown Persistence

What happens if an arena is destroyed and the server suddenly crashes or restarts before the reset interval?

• AdvancedFFA continuously tracks modified ("dirty") blocks inside an SQLite table.
• Clean Shutdown: The plugin performs an immediate synchronous restoration of all dirty arenas before the server halts.
• Crash Recovery: If the server unexpectedly crashes or loses power, AdvancedFFA detects the pending dirty blocks upon startup and restores the arenas before opening queues.

---

Arena Options Reference

Option	Command	Default	Description
Allow Break	/ffa arena edit <name> allowBreak <true|false>	false	Allows players to break blocks inside the arena
Allow Place	/ffa arena edit <name> allowPlace <true|false>	false	Allows players to place blocks inside the arena
Max Players	/ffa arena edit <name> maxPlayers <unlimited|count>	0 (unlimited)	Caps the maximum number of players allowed in this arena
Reset Interval	/ffa arena edit <name> resetInterval <default|mins>	0 (default)	Custom reset frequency in minutes
AFK Protection	/ffa arena edit <name> giveProtection <true|false>	true	Grants temporary invulnerability until the player moves or attacks
Link Kit	/ffa arena edit <name> linkWithKit <kit>	none	Links the arena to a specific kit loadout
Queue Access	/ffa arena edit <name> allowQueue <true|false>	false	Opens or closes the arena. Disabling safely kicks players to lobby
Display Name	/ffa arena edit <name> setDisplayName <text>	ID	Sets a custom formatted display name