Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/GuidesUpdated in v1.4.0

Set the rules of a kit

Change how a kit plays with toggles, numbers and attributes, each with its default and what enforces it.

Page 8 of 358 min read

You will change how one kit plays: whether players can build, how a match is won, which cooldowns apply, what effects and attributes they start with. The rules are stored as JSON on the kit row. Most become policies on the arena's region for the length of the match; the rest are enforced by the plugin's own match listener.

Before you start#

Steps#

Open the rules screen

Run /epc, click Manage kits → All kits → your kit → Kit rules. The screen is a hub of seven cards: Arena flags, Combat, Win conditions, Cooldowns, Potion effects, Attributes and Special conditions.

Open the card for what you want to change

Building and item rules are in Arena flags; hit delay, build height and damage in Combat; hits, points, revives and rounds in Win conditions; pearl, golden apple and arrow cooldowns plus the start countdown in Cooldowns.

Change the value

Toggles flip with one click. Numbers use left click for +1 and right click for -1 (Shift for 5). Durations are typed in chat as a length of time, such as 250ms, 3s or 1m30s.

Go back and test

Each click updates the kit straight away. Start a match with the kit to see the rule at work.

Times are typed, not clicked

Every duration on these screens is asked for as a length of time (250ms, 3s, 1m30s) instead of being clicked up one second at a time. Anything the plugin writes back reads the same way, so 0s means off wherever a rule takes a time.

Recipes#

A boxing kit#

Open Win conditions and set Hits to win to 100. Nothing else is needed: the first player to take 100 hits loses. The sidebar's %hits% is your own hits received and %opp_hits% is your opponent's.

First to 3 points#

In Win conditions set Points to win to 3, leave Kills give points on and set Revive time to 5s. An elimination scores, the loser is revived after the revive time, and Regenerate after point optionally restores the arena between points. To score another way, see Special conditions.

A building kit#

Open Arena flags and set build and block-break on. To stop players tearing up the map, also turn on player-build-only so only blocks players placed can be broken. Set a Build height limit in Combat to stop towering. Block placing and breaking is also blocked inside the arena's spawn protection and extra region protection radii, whatever these rules say.

Best of 3 in the queue#

Win conditions → Queue rounds: 2 is best of 3, 3 is best of 5. 0 follows the server setting queue.rounds-to-win (1 by default, a single fight) from Configuration.

Give players potion effects#

Left click Potion effects to open the effect editor. Each entry is an effect name, a level and a duration in seconds; a duration of infinite lasts the whole match. Every existing effect on the player is stripped first, so what a kit grants is exactly what the player has. Right click the card to toggle whether the effects come back after a Totem of Undying pops.

Change health, damage or speed#

Open Attributes. Left click an attribute to type its value, right click to reset it to vanilla.

Check that it works#

  • Start a match with the kit and try the rule: place a block, take the number of hits, throw a pearl twice.
  • The cards on the rules screen summarise the current values (for example Hits, Points, Pearl, Gapple, Arrow, active effects, active triggers), so you can read them back without opening each one.

Going further#

Arena flags: building and items

Set from Arena flags, the shared flag editor, where Default stores the value in the table below.

RuleDefaultWhat it does
buildoffPlayers may place blocks
block-breakoffPlayers may break blocks
interactonPlayers may interact with blocks
player-build-onlyoffOnly blocks players placed may be broken
disappearing-blocks-delay0Seconds before a placed block vanishes. 0 disables it.
re-give-blocksoffThe block is handed back when it disappears
item-droponPlayers may drop items
item-pickuponPlayers may pick items up
pvponPlayers may damage each other
fall-damageonFall damage applies

A player is put in adventure mode when build, block-break and player-build-only are all off, and in survival otherwise. There is no game-mode setting.

Combat: damage and health
RuleDefaultWhat it does
disabled-damageoffAll damage is off
health-regenerationonNatural regeneration
food-decreasingonHunger drains
hit-delay20The player's maximumNoDamageTicks, the invulnerability window after a hit, in ticks. 20 is vanilla; lower it for combo kits. Typed in chat as 250ms, 1s or 0s.
build-height-limit0How many blocks above the arena's highest spawn (either team's, or the party FFA one) players may place blocks, the same ceiling for everybody. Higher is refused with game.build-height-limit. 0 means no limit beyond the arena's region.
Win conditions
RuleDefaultWhat it does
hits-to-win0A player who has received this many hits is eliminated. 0 disables it.
points-to-win-1Points needed to win. -1 disables it.
kills-give-pointsonAn elimination awards a point
revive-time0Seconds an eliminated player spectates before respawning. 0 disables revives.
rounds-to-win0Rounds a player must win to take a queue match, ranked or unranked. 0 follows the server's queue.rounds-to-win.
bed-respawnoffKilled players respawn, after revive-time, while their team's bed stands. Once an enemy breaks it, their next death is final.
iron-plate-checkpointsoffHeavy weighted pressure plates set a checkpoint. Dying or leaving the arena returns you there instead of eliminating you.
regenerate-after-pointoffThe arena is restored from its schematic between points

Points and revives together turn a 1v1 into a first-to-N.

Bed respawn. With bed-respawn on, a bed belongs to the team whose spawn it is closest to. An enemy can always break it, whatever the kit's break rules or the arena's protection say, and nobody can break their own. The whole match is told whose bed fell and who broke it. While the bed stands a death never ends the match, and points are not scored from kills. It applies to team and 1v1 fights, not to a party FFA or a fight against bots, and the arena is regenerated after the match.

Checkpoints. A player sent back to a checkpoint gets no invulnerability on arrival. Checkpoints are per plate and one-shot: standing on the same block again does not re-arm it, but a new plate does. They reset at the start of every round and every point.

Cooldowns and the start countdown
RuleDefaultWhat it does
ender-pearl-cooldown0Cooldown between pearls. 0 uses the server default.
golden-apple-cooldown0Cooldown on both golden apple types, in seconds. 0 disables it.
arrow-cooldown0Seconds a bow or crossbow waits between shots. A player left with no arrows gets one back when the wait ends. 0 disables it.
start-countdownonThe match opens with the start countdown. Off, the fight starts as soon as the arena is ready, with no skip vote.

These three cooldowns are stored in seconds, unlike hit-delay, which is in ticks. Older builds mislabelled the pearl one as ticks in the rules menu; the value it stored was always seconds, so an existing kit needs no change.

Attributes and starting state

Set from Attributes. -1 on any of them means leave the vanilla value alone. Attributes are applied as base values at the start of a match and again after every point reset.

AttributeVanillaRange
max-health20
attack-damage2
movement-speed0.1
knockback-resistance0up to 1
start-healthfullcapped at max health
start-food200 to 20
start-saturation200 to 20
Potion effects and totems

Each effect is stored as an effect name, an amplifier and a duration in seconds (-1 lasts the whole match), plus the particles, icon and ambient flags the editor shows.

A Totem of Undying clears the kit's effects, as it does in vanilla. The keep_effects_on_totem rule (off by default, and off for kits saved before it existed) gives them back after the totem pops, with a timed effect returning only the time it had left. Potions the player drank go with the totem either way.

Something missing on this page? Tell us on Discord