Reference

Configuration

Every key in config.yml, with its default and what it changes.

config.yml is version 2 and carries eighteen sections. Every one is generated on first boot with the defaults below.

Every value here is read fresh on each access, so /epc reload is enough to apply an edit — with the one exception noted under duel below.

`arena`

Key	Default	What it does
`max-clones-per-arena`	`10`	Hard ceiling of simultaneous copies of one arena
`clone-spacing`	`1500`	Blocks of empty space between clones
`clone-paste-y`	`64`	The Y a clone's copy region is pasted at

`pvp-regions`

Key	What it does
`combat-tag-bossbar`	The boss bar shown while combat-tagged in a PvP zone. `%time%` is the seconds left.

`season`

Key	Default	What it does
`progress-bossbar`		The bar shown during a rotation, with `%phase%` and `%percent%`
`restart-after-rotation`	`true`	Restart the server once a rotation finishes
`restart-delay-seconds`	`15`	The countdown before that restart

`game`

Key	Default	What it does
`countdown-seconds`	`5`	Length of the pre-match countdown
`countdown-title`		Shown each second, with `%time%`
`fight-title`		Shown when the match starts
`you-won-title` / `you-lost-title` / `draw-title`		The three results
`match-actionbar`		The live combat readout
`barrier-blocks-pearl`	`true`	An ender pearl hitting a barrier block is stopped
`countdown-tick-sound`	`BLOCK_NOTE_BLOCK_HAT\|1.0\|1.0`
`countdown-fight-sound`	`ENTITY_ENDER_DRAGON_GROWL\|0.5\|1.3`
`you-won-sound`	`UI_TOAST_CHALLENGE_COMPLETE\|1.0\|1.0`
`you-lost-sound`	`ENTITY_VILLAGER_DEATH\|1.0\|1.0`
`draw-sound`	`BLOCK_NOTE_BLOCK_PLING\|1.0\|0.5`

`queue`

Key	Default	What it does
`in-queue-actionbar`		The bar a queued player sees: `%kits%`, `%time%`, `%elo%`
`match-found-title`		Shown when a pairing happens
`match-found-actionbar`		Shown while the arena is prepared, with `%spinner%`
`no-clone-extra-delay`	`40`	Ticks added when no clone was needed, so an instant match is not jarring
`teaser-enabled`	`true`	The rotating queue advertisement
`teaser-rotation-seconds`	`5`	How long each queued player is featured
`teaser-max-kits-shown`	`3`	Kits listed before collapsing to `+N`
`teaser-bossbar`		Its appearance, with `%player%` and `%kits%`

`party`

Key	Default	What it does
`min-size`	`2`	The smallest a leader may set the maximum to
`default-max-size`	`10`	The maximum for a leader with no `max_slots` node
`max-size`	`100`	The absolute ceiling, whatever the permission says
`ffa-spawn-radius`	`7`	How far around the FFA spawn players are scattered
`announce-cooldown-seconds`	`60`	Rate limit on `/party announce`

`duel`

Key	Default	What it does
`request-expiry-seconds`	`30`	How long a challenge stays open
`round-end-delay-ticks`	`80`	The pause between rounds
`round-won-title` / `round-lost-title` / `round-draw-title`		With `%my_wins%` and `%their_wins%`

request-expiry-seconds is read once

The expiry is baked into a cache when the plugin enables. It is the one key in this file that a /epc reload cannot pick up — changing it needs a restart.

`leaderboard`

Key	Default	What it does
`max-entries`	`50`	Rows a leaderboard holds. Also the cut-off `%exyliapracticecore_stats_rank_position%` reports as `#51+`.

`elo`

Key	Default	What it does
`starting-mmr`	`400`	Where a new player starts
`matchmaking-base-radius`	`150`	Initial search band
`matchmaking-expand-rate`	`50`	Added per interval
`matchmaking-expand-interval-seconds`	`15`	How often it widens
`matchmaking-max-radius`	`600`	The widest it gets
`matchmaking-ignore-elo`	`false`	Pair anybody with anybody
`lp-max-per-game`	`25`	Cap on the movement per match
`asymmetric-threshold-mmr`	`200`	Rating gap at which loss reduction starts
`asymmetric-reduction-per-100-mmr`	`5`	LP added back per 100 MMR of gap
`asymmetric-min-loss`	`5`	Bound on the reduced loss
`placement-game-count`	`10`	Ranked games before placements end
`placement-k-multiplier`	`2.0`	K multiplier during placements
`flat-elo-enabled`	`false`	Replace the formula with two fixed numbers
`flat-elo-win`	`25`
`flat-elo-loss`	`25`

`elo-security`

Key	Default	What it does
`enabled`	`true`	The master switch
`same-ip-protection`	`true`	Never pair two players from one address
`opponent-cooldown`	`true`	Never re-pair two players too soon
`opponent-cooldown-seconds`	`300`	How soon is too soon

`spectator`

Key	Default
`toggle-hiding-material`	`GRAY_DYE`
`toggle-hiding-name`	`{error}Spectators Hidden`
`toggle-visible-material`	`LIME_DYE`
`toggle-visible-name`	`{success}Spectators Visible`

`join-quit`

Key	Default	What it does
`join-enabled`	`true`	Broadcast the plugin's own join message
`quit-enabled`	`true`	The same for quitting

Vanilla join and quit messages are suppressed either way.

`ui`

Key	Default	What it does
`status-enabled-material`	`LIME_DYE`	The "on" icon in every toggle menu
`status-disabled-material`	`GRAY_DYE`	The "off" icon

`jumpad`

Key	Default
`launch-cooldown-ms`	`500`
`only-lobby-area`	`true`
`launch-sound`	`ENTITY_SLIME_JUMP\|1.0\|1.2`

`lobby-visibility`

The defaults a player who has never opened /settings gets.

Key	Default	What it does
`show-vip-default`	`true`	See players with `exyliapractice.lobby.vip`
`show-party-default`	`true`	See your own party
`show-others-default`	`false`	See everybody else

`lobby`

Key	Default
`double-jump-enabled`	`true`
`double-jump-vertical-power`	`0.9`
`double-jump-forward-power`	`0.6`
`double-jump-cooldown-ms`	`500`
`double-jump-sound`	`ENTITY_ENDER_DRAGON_FLAP\|0.6\|1.8`
`effects`	`[SPEED\|2]`

`command-whitelist`

Key	Default	What it does
`enabled`	`true`	Restrict commands in a match, in a queue and in a PvP zone
`commands`	see below	The allowed list

commands: [msg, message, tell, w, whisper, reply, r, respond,
           leave, lq, leavequeue, epc, exyliapracticecore, kitsave, leave]

`web-api`

Key	Default	What it does
`enabled`	`false`	Turn the whole integration on
`key`	`""`	Your server key. Blank keeps it off even when `enabled` is true.
`sync-on-startup`	`true`	Push ranks and kits shortly after boot
`player-count-interval-seconds`	`300`	How often the online count is reported

See the web API page.

Migration from ExyliaCommons

A config.yml with no config-version is treated as version 1 — the ExyliaCommons layout — and migrated in place. Every title, action bar and boss bar block is moved into the nested section the library expects, title durations are converted from ticks to seconds, and the obsolete %time_decimal% token is rewritten to %time%.

The six sections ExyliaCommons registered against this same file — debug, formatters, text, tasks, chat-input, discord — were the library's own settings and are removed on first load, each reported once as UNKNOWN_KEY. They live in ExyliaLib's files now.

Something missing on this page? Tell us on Discord