Configuring

Arenas

Every field on an arena, what it does, and where it is stored.

An arena is a row in the database, not a block of YAML. It is created and edited from /ffaadmin, and each change writes a new row: nothing is mutated in shared memory, so two admins touching the same arena at once cannot leave it half-written.

Fields

idtext, max 64

The arena identifier, chosen by whoever created it. It is what goes in /ffa join <id> and in placeholders. It cannot be changed afterwards.

displayNametext, max 128

The name menus show. Accepts colours and palette tokens.

iconMaterialmaterialpor defecto DIAMOND_SWORD

The icon in the arena selector.

maxPlayersintegerpor defecto 50

How many players fit inside at once. Spectators do not take a combat slot, but they do count towards the occupancy placeholder.

kitModeSELECTABLE | RANDOMpor defecto SELECTABLE

SELECTABLE lets players pick a kit on entry when there is more than one. RANDOM hands out one at random among the kits that player is allowed to use.

resetKitAfterKillbooleanpor defecto false

When on, every kill refills the killer's kit back to its original state.

regiontwo corners

The arena bounds. Without a region, the arena cannot register as a playable session.

protectedRadiusinteger, blockspor defecto 0

Protection radius around each spawn. 0 disables protection.

protectedShapeSPHERE | CUBOIDpor defecto SPHERE

The shape of that radius.

protectedModeNORMAL | FULL_HEIGHTpor defecto NORMAL

FULL_HEIGHT extends protection from bedrock to sky, which stops anyone from standing above spawn to hit whoever appears.

permissiontextpor defecto empty

Permission required to join. Empty means anyone can. This is the mechanism for premium arenas.

regenerationTimesecondspor defecto 0

How often the arena's schematic is restored. 0 disables automatic regeneration.

priorityintegerpor defecto 0

Ordering in menus and in arena selection. Higher priority shows first.

enabledbooleanpor defecto false

Whether players may join at all. A newly created arena stays disabled until you switch it on.

saveInventoryOnLeavebooleanpor defecto false

Stores the inventory the player brought and gives it back on leave. Recommended where FFA coexists with survival, or with a lobby that hands out items.

rulesrules block

The twenty-one in-arena rules. See Rules.

Spawn protection

Three fields combine: the radius, the shape and the mode.

Combination	Result
Radius `0`	No protection. Spawn is just another point of the arena.
`SPHERE` + `NORMAL`	A sphere around spawn. The natural choice in flat arenas.
`CUBOID` + `NORMAL`	A cube. Useful when spawn sits on a square platform.
Either + `FULL_HEIGHT`	Protection ignores height: floor to sky.

Picking a radius

Radii of 3 to 5 blocks are usually enough. A large radius turns spawn into a shelter and players learn to fight on its edge.

Paid arenas

An arena with a permission is a restricted arena. The menu still shows it, but joining requires the permission. Combined with kit and spawn permissions, it lets you design tiered access without duplicating arenas.

exyliaffa.arena.vip      → the "vip" arena
exyliaffa.kit.diamond    → the "diamond" kit in any arena
exyliaffa.spawn.tower    → the "tower" spawn of one arena

The nodes are whatever you write in each field: the plugin imposes no prefix.

Live state

An arena that is enabled and has a region registers as a session when the server starts. The session is what holds the list of living players, the spectators, the regeneration timer and the scoreboard. Disabling an arena closes its session and returns everyone to the lobby.

Something missing on this page? Tell us on Discord