Configuration
Where ExyliaPracticeCore's files are, how to reload them, and every config.yml key with its default.
Most settings are a button, not a file: run /epc and click Settings. Open this page when you want a file's location, a default, or every key at once.
The files live in plugins/ExyliaPracticeCore/: config.yml for the settings below, ranks.yml for the ranks, and a lang/<code>/ folder with the messages, sidebars and menus a player reads. All of them are generated on first boot with their defaults.
Editing in game and reloading#
/epc → Settings (needs exyliapractice.admin), or /exylialib config ExyliaPracticeCore, opens ExyliaLib's settings screens for config.yml, one page per group: Lobby, Matches, Parties & queue, Ranked, Seasons & replays. What you change there is checked and written back to the file. messages.yml and scoreboards.yml are not on those screens.
Editing the file by hand works too: save it and run /epc reload. Values are read fresh on each use, with one exception, duel.request-expiry-seconds, which needs a restart. To translate or recolour text, see messages and languages and colours.
Titles, action bars, boss bars and item names are not in config.yml. They sit in the language's messages.yml, under effects (countdown-title, fight-title, you-won-title, you-lost-title, draw-title, match-actionbar, bot-actionbar, in-queue-actionbar, match-found-title, match-found-actionbar, teaser-bossbar, round-won-title, round-lost-title, round-draw-title, combat-tag-bossbar, season-progress-bossbar) and labels (spectators-hidden, spectators-visible). A server coming from version 2 has its edited blocks moved there on the first start, so nothing it wrote is lost.
language#
language: defaultWhich folder under plugins/ExyliaPracticeCore/lang/ the menus, messages, scoreboards, hotbar items and replay controls are read from. default follows the language set in ExyliaLib's own config.yml; en, es, pt, fr, ru or tr set this plugin alone. A server that ran the plugin before languages existed has its own files moved to lang/custom/ and is pointed at it with language: custom, so nothing it edited is lost.
What owners change most#
game.countdown-seconds (5), game.start-animation.style (none, gate, rise, cage)Best of 3 or 5queue.rounds-to-win: 1 single fight, 2 best of 3, 3 best of 5Party sizesparty.default-max-size (10) and party.max-size (100)Season restartseason.restart-after-rotation and restart-delay-secondsReplay storagereplay.retention-days (14) and replay.ranked-onlyMatchmaking and ELOSearch radius, LP per match, placementsIf ExyliaLobby is installed, the plugin hands the lobby over to it by default: see defer-to-exylia-lobby below. If several servers share one database, see places-scope.
Every key, section by section
Top level#
| Key | Default | What it does |
|---|---|---|
language | default | See above |
defer-to-exylia-lobby | true | With ExyliaLobby installed, the lobby jump pads, the portal and PvP regions, the double jump and the show/hide-players toggle are left to it. Queues, parties and matches are untouched. false keeps this plugin's own lobby features. |
places-scope | default | Which servers share the arenas, jump pads and the PvP and portal regions. default follows the network group set in ExyliaLib's config.yml (identical servers of a pool share them; no group means every server shares), server gives each server its own, global shares them with all. |
arena#
| Key | Default | What it does |
|---|---|---|
max-clones-per-arena | 10 | Hard ceiling of simultaneous copies of one arena |
clone-paste-y | 64 | The Y a clone's copy region is pasted at |
See Clones.
season#
| Key | Default | What it does |
|---|---|---|
restart-after-rotation | true | Restart the server once a rotation finishes. Pending stats are written and the web outbox is delivered first. |
restart-delay-seconds | 15 | Seconds players are warned before that restart (0-300). Matchmaking stays locked. |
See Seasons.
game#
| Key | Default | What it does |
|---|---|---|
countdown-seconds | 5 | Length of the pre-match countdown (0-60) |
barrier-blocks-pearl | true | An ender pearl hitting a barrier block is stopped |
countdown-tick-sound | BLOCK_NOTE_BLOCK_HAT|1.0|1.0 | Sound each countdown second, as SOUND|volume|pitch |
countdown-fight-sound | BLOCK_NOTE_BLOCK_PLING|0.8|2.0 | Sound when the fight starts |
you-won-sound | ENTITY_PLAYER_LEVELUP|0.6|1.2 | Sound for the winner |
you-lost-sound | BLOCK_NOTE_BLOCK_BASS|0.8|0.6 | Sound for the loser |
draw-sound | BLOCK_NOTE_BLOCK_PLING|1.0|0.5 | Sound for a draw |
countdown-skip-vote | true | Players can end the start countdown early by clicking, once every fighter agrees |
start-animation.style | none | How 1v1 fighters wait during the countdown, shown to the fighters only (needs PacketEvents): none; gate, bars that rise at the fight start, needing marker blocks in front of each spawn; rise, fighters come up from under the floor, nothing to set up; cage, a glass cage that breaks. An arena can pick its own style under Start animation in its setup menu. |
start-animation.gate.marker | STRUCTURE_BLOCK | The block builders place where the bars go, within 8 blocks of a spawn. Taken out while a match runs and put back when it ends. |
start-animation.gate.bars | IRON_BARS | The block of the bars |
start-animation.gate.sound | BLOCK_CHAIN_PLACE|1.0|0.7 | Played as each row of bars rises |
start-animation.rise.sound | BLOCK_PISTON_EXTEND|0.5|1.2 | Played at each block the fighter comes up |
start-animation.cage.material | GLASS | The block of the cage |
start-animation.cage.sound | BLOCK_GLASS_BREAK|0.6|1.2 | Played when it breaks |
queue#
| Key | Default | What it does |
|---|---|---|
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 |
rounds-to-win | 1 | Rounds a player must win to take a queue match, ranked and unranked (1-10). 1 is a single fight, 2 best of 3, 3 best of 5. A kit can set its own under Kit rules » Win conditions. |
See Queue.
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 | Seconds between a leader's /party announce (0-3600). A rank lowers it with exyliapractice.party.announce.cooldown.<n>; the lowest node held wins. |
See Parties.
duel#
| Key | Default | What it does |
|---|---|---|
request-expiry-seconds | 30 | How long a challenge stays open (5-300) |
round-end-delay-ticks | 80 | The pause between rounds |
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 (5-500). 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 | LP for a win when flat ELO is on |
flat-elo-loss | 25 | LP lost when flat ELO is on |
result-animation.style | card | How a ranked player sees their LP bar move after the match: none (chat only), card (a card floats in front of them in the arena) or screen (a full-screen summary once they are back in the lobby). Both need PacketEvents. New in v1.5.0 |
result-animation.fill-millis | 1100 | How long a whole bar takes to fill, in milliseconds |
result-animation.rank-change-pause-millis | 500 | The hold where the bar changes division or rank |
result-animation.tick-sound / rank-up-sound / rank-down-sound | note block, level-up, bass | Sounds as the bar fills and when it crosses a division or rank |
result-animation.card.distance / lift / bar-cells | 2.6 / 0.0 / 20 | How far in front, how far above eye level and how wide the card is |
result-animation.screen.close-after-seconds | 6 | Seconds the summary stays open once the bar stops; 0 keeps it until closed |
See ELO and ranks.
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-visible-material | LIME_DYE |
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 |
menu-style | CLASSIC | CLASSIC opens the lobby menus as chest windows. SCREEN opens the full-screen hub drawn in front of the player (screens/practice_hub.html) and draws the other menus as cards. DEFAULT follows ExyliaLib's screens.yml. A player may pick their own in /settings when screens.yml allows it. |
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. Players who already changed a setting keep their own choice.
| 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 |
double-sneak-toggle | true | Sneaking twice quickly in the lobby shows or hides everybody else |
double-sneak-window-ms | 400 | How close together the two sneaks must be |
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_BAT_TAKEOFF|0.5|1.4 |
effects | [SPEED|2] |
See Lobby.
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, practiceadmin, 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.yml shortly after boot |
player-count-interval-seconds | 300 | How often the online count is reported |
See the web API page.
chat#
| Key | Default | What it does |
|---|---|---|
isolation | true | Keep a match's chat inside that match: whoever is fighting or watching it reads that match and nothing else, party members always read each other, and the lobby reads none of it. false leaves chat as the server's chat plugin delivers it. |
world-border#
| Key | Default | What it does |
|---|---|---|
enabled | true | Draw a border around arenas and combat-tagged PvP zones. It is only drawn: false saves client FPS in small arenas, and arena bounds are still enforced. |
replay#
| Key | Default | What it does |
|---|---|---|
enabled | true | Whether matches are recorded at all |
ranked-only | false | Record ranked matches only. Unranked duels are the bulk of the rows. |
retention-days | 14 | How long a recording stays watchable (1-365). Past this it is deleted; the match stays in the history. |
max-concurrent-viewers | 5 | How many recordings may be watched at once, across the server (1-100) |
inventory-retention-days | 14 | How long a match keeps its saved inventories, what /history inv shows (1-365). Past this they are cleared; the match itself stays in the history for 60 days. |
See match history.
Version 5 sounds#
Version 5 swaps the long, loud match and double-jump sounds for short, quiet ones. On the first start after the update, game.countdown-fight-sound, game.you-won-sound, game.you-lost-sound and lobby.double-jump-sound are replaced only where they still hold the old shipped value; a sound you picked yourself is kept. messages.yml (version 3) does the same for the leading sound tags of game.bed-destroyed, elo.rank-up, the season start and end lines, link-profile.success and the two bot-pvp lines.
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