Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/ReferenceUpdated in v1.5.0

Configuration

Where ExyliaPracticeCore's files are, how to reload them, and every config.yml key with its default.

Page 25 of 3512 min read

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.

The text a player reads lives in messages.yml

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#

yaml
language: default

Which 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#

If 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#

KeyDefaultWhat it does
languagedefaultSee above
defer-to-exylia-lobbytrueWith 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-scopedefaultWhich 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#

KeyDefaultWhat it does
max-clones-per-arena10Hard ceiling of simultaneous copies of one arena
clone-paste-y64The Y a clone's copy region is pasted at

See Clones.

season#

KeyDefaultWhat it does
restart-after-rotationtrueRestart the server once a rotation finishes. Pending stats are written and the web outbox is delivered first.
restart-delay-seconds15Seconds players are warned before that restart (0-300). Matchmaking stays locked.

See Seasons.

game#

KeyDefaultWhat it does
countdown-seconds5Length of the pre-match countdown (0-60)
barrier-blocks-pearltrueAn ender pearl hitting a barrier block is stopped
countdown-tick-soundBLOCK_NOTE_BLOCK_HAT|1.0|1.0Sound each countdown second, as SOUND|volume|pitch
countdown-fight-soundBLOCK_NOTE_BLOCK_PLING|0.8|2.0Sound when the fight starts
you-won-soundENTITY_PLAYER_LEVELUP|0.6|1.2Sound for the winner
you-lost-soundBLOCK_NOTE_BLOCK_BASS|0.8|0.6Sound for the loser
draw-soundBLOCK_NOTE_BLOCK_PLING|1.0|0.5Sound for a draw
countdown-skip-votetruePlayers can end the start countdown early by clicking, once every fighter agrees
start-animation.stylenoneHow 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.markerSTRUCTURE_BLOCKThe 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.barsIRON_BARSThe block of the bars
start-animation.gate.soundBLOCK_CHAIN_PLACE|1.0|0.7Played as each row of bars rises
start-animation.rise.soundBLOCK_PISTON_EXTEND|0.5|1.2Played at each block the fighter comes up
start-animation.cage.materialGLASSThe block of the cage
start-animation.cage.soundBLOCK_GLASS_BREAK|0.6|1.2Played when it breaks

queue#

KeyDefaultWhat it does
no-clone-extra-delay40Ticks added when no clone was needed, so an instant match is not jarring
teaser-enabledtrueThe rotating queue advertisement
teaser-rotation-seconds5How long each queued player is featured
teaser-max-kits-shown3Kits listed before collapsing to +N
rounds-to-win1Rounds 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#

KeyDefaultWhat it does
min-size2The smallest a leader may set the maximum to
default-max-size10The maximum for a leader with no max_slots node
max-size100The absolute ceiling, whatever the permission says
ffa-spawn-radius7How far around the FFA spawn players are scattered
announce-cooldown-seconds60Seconds 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#

KeyDefaultWhat it does
request-expiry-seconds30How long a challenge stays open (5-300)
round-end-delay-ticks80The pause between rounds
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#

KeyDefaultWhat it does
max-entries50Rows a leaderboard holds (5-500). Also the cut-off %exyliapracticecore_stats_rank_position% reports as #51+.

elo#

KeyDefaultWhat it does
starting-mmr400Where a new player starts
matchmaking-base-radius150Initial search band
matchmaking-expand-rate50Added per interval
matchmaking-expand-interval-seconds15How often it widens
matchmaking-max-radius600The widest it gets
matchmaking-ignore-elofalsePair anybody with anybody
lp-max-per-game25Cap on the movement per match
asymmetric-threshold-mmr200Rating gap at which loss reduction starts
asymmetric-reduction-per-100-mmr5LP added back per 100 MMR of gap
asymmetric-min-loss5Bound on the reduced loss
placement-game-count10Ranked games before placements end
placement-k-multiplier2.0K multiplier during placements
flat-elo-enabledfalseReplace the formula with two fixed numbers
flat-elo-win25LP for a win when flat ELO is on
flat-elo-loss25LP lost when flat ELO is on
result-animation.stylecardHow 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-millis1100How long a whole bar takes to fill, in milliseconds
result-animation.rank-change-pause-millis500The hold where the bar changes division or rank
result-animation.tick-sound / rank-up-sound / rank-down-soundnote block, level-up, bassSounds as the bar fills and when it crosses a division or rank
result-animation.card.distance / lift / bar-cells2.6 / 0.0 / 20How far in front, how far above eye level and how wide the card is
result-animation.screen.close-after-seconds6Seconds the summary stays open once the bar stops; 0 keeps it until closed

See ELO and ranks.

elo-security#

KeyDefaultWhat it does
enabledtrueThe master switch
same-ip-protectiontrueNever pair two players from one address
opponent-cooldowntrueNever re-pair two players too soon
opponent-cooldown-seconds300How soon is too soon

spectator#

KeyDefault
toggle-hiding-materialGRAY_DYE
toggle-visible-materialLIME_DYE

join-quit#

KeyDefaultWhat it does
join-enabledtrueBroadcast the plugin's own join message
quit-enabledtrueThe same for quitting

Vanilla join and quit messages are suppressed either way.

ui#

KeyDefaultWhat it does
status-enabled-materialLIME_DYEThe "on" icon in every toggle menu
status-disabled-materialGRAY_DYEThe "off" icon
menu-styleCLASSICCLASSIC 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#

KeyDefault
launch-cooldown-ms500
only-lobby-areatrue
launch-soundENTITY_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.

KeyDefaultWhat it does
show-vip-defaulttrueSee players with exyliapractice.lobby.vip
show-party-defaulttrueSee your own party
show-others-defaultfalseSee everybody else
double-sneak-toggletrueSneaking twice quickly in the lobby shows or hides everybody else
double-sneak-window-ms400How close together the two sneaks must be

lobby#

KeyDefault
double-jump-enabledtrue
double-jump-vertical-power0.9
double-jump-forward-power0.6
double-jump-cooldown-ms500
double-jump-soundENTITY_BAT_TAKEOFF|0.5|1.4
effects[SPEED|2]

See Lobby.

command-whitelist#

KeyDefaultWhat it does
enabledtrueRestrict commands in a match, in a queue and in a PvP zone
commandssee belowThe allowed list
yaml
commands: [msg, message, tell, w, whisper, reply, r, respond,
           leave, lq, leavequeue, practiceadmin, epc, exyliapracticecore, kitsave, leave]

web-api#

KeyDefaultWhat it does
enabledfalseTurn the whole integration on
key""Your server key. Blank keeps it off even when enabled is true.
sync-on-startuptruePush ranks.yml shortly after boot
player-count-interval-seconds300How often the online count is reported

See the web API page.

chat#

KeyDefaultWhat it does
isolationtrueKeep 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#

KeyDefaultWhat it does
enabledtrueDraw 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#

KeyDefaultWhat it does
enabledtrueWhether matches are recorded at all
ranked-onlyfalseRecord ranked matches only. Unranked duels are the bulk of the rows.
retention-days14How long a recording stays watchable (1-365). Past this it is deleted; the match stays in the history.
max-concurrent-viewers5How many recordings may be watched at once, across the server (1-100)
inventory-retention-days14How 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