Arenas and kits

Everything is set up in game with /duelsadmin (also /dueladmin), which needs exyliaduels.admin. The panel has four cards: Arenas (with how many exist and how many are ready), Kits, Settings and All settings. Every change is saved at once; nothing needs a reload.

An arena only provides the place. How a duel is played, its arena flags and its rules, belongs to what the players fight with: each server kit, each kit another plugin offers, and own inventory carry their own. A kit with nothing set plays as a plain duel.

Arenas

An arena is a box in a world with two spawns. It is saved as a schematic, regenerated from it after every duel, and copied into ExyliaLib's temporary world while it is busy.

Creating one

An arena is ready, and duels can be sent to it, only while it is enabled, both spawns are set, its world is loaded and its schematic is saved. Anything else keeps it out, so a duel is never sent to half an arena. The list and the hub show Ready or Not ready (world or schematic missing).

The arena hub

In the arena list, left-click opens an arena and right-click deletes it, after a confirmation. Deleting keeps its schematic file; a duel being fought in it keeps it until the duel ends.

Copies and regeneration

When a duel needs an arena that is busy, a copy of its schematic is pasted in the temporary world, up to its Copies. After every duel the arena, or the copy, is regenerated from the schematic, so blocks placed in a fight are gone. On start, idle arenas are regenerated too: a crash mid-duel leaves no trace.

Renaming an arena or changing its kit keeps the copies already made; changing its box, spawns or copies drops them.

Kit arenas

An arena bound to a kit (a Mace arena, an Elytra Spear arena) only hosts duels with that kit:

• In the challenge screen, picking the arena picks its kit too.
• A challenge on any other terms is refused, on send and again on accept: "The arena … only allows the … kit."
• A random arena for a kit duel prefers the arenas bound to that kit, then the unbound ones.
• Own-inventory duels only ever use unbound arenas.

Deleting a kit unbinds every arena bound to it.

Kits

A kit is what both players wear in a server-kit duel. Kit items never leave the arena: they cannot be dropped, and they are taken off when the duel ends.

Kits → Create kit, and type an id. The new kit starts as what you are wearing, and disabled. In its screen:

The kit mode is offered while at least one kit is enabled, or another plugin offers one. Who may pick a kit is up to exyliaduels.kit.<id>: see Permissions.

Arena flags

ExyliaLib's flag editor, over the arena the duel is given: PvP, building, breaking, player-placed blocks only, interacting, timed blocks that vanish after a number of seconds, giving placed blocks back, item drop, item pickup and fall damage. A flag left on Default keeps the arena's own answer. The flags hold only the two fighters of the duel, and each duel sets them afresh, so a copy never keeps the flags of the kit fought there before.

Rules

Each kit sets how its duels are played on three pages. A rule left on its default plays as a plain duel, and everything a rule changes on a player is given back with the rest of them when the duel ends.

Fight start

Combat

Win condition

A death always loses. On top of it:

Kits from other plugins

Another plugin can offer kits to the challenge screen, such as the Random kit of ExyliaRandomKitsCore. They are listed in Kits after the server's, marked From <source>. Their items, name and icon belong to the plugin that offers them, so their screen only sets Arena flags, Fight start, Combat and Win condition, applied after the source has dressed the players. They cannot be deleted here, and on a server without that plugin they are simply not offered. Their permission node is exyliaduels.kit.<source>:<kit>, such as exyliaduels.kit.randomkits:random.

Settings

Settings is saved straight to config.yml.

See Configuration for what each one does. All settings, on the panel, opens every key of config.yml in ExyliaLib's settings screens, and BACK returns to the panel.

Own inventory rules

Every duel fought with the players' own items, kept or at risk, plays under one set of Arena flags, Combat rules and a Win condition of hits to win and fall depth. The start state, effects, attributes and rounds are left out: the players' own items decide how they start, and they cannot be put back between rounds, so an own inventory duel is always a single fight.