Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/How it worksUpdated in v1.4.0

Statistics

What ExyliaPracticeCore counts, when a match writes its numbers, how the leaderboards are built and how to correct a player's stats.

Page 19 of 355 min read

ExyliaPracticeCore keeps a set of counters for every player on every kit (wins, kills, damage, streaks, rating and more), plus an overall "global" ladder. This page explains where those numbers live, when a match writes them, how /stats ranks players and how an admin corrects them. You do not need to set anything up: stats are counted from the first match.

Three tiers#

TierTableScope
Seasonpractice_player_season_statsOne row per player, per kit, per season
Lifetimepractice_player_lifetime_statsOne row per player, per kit, across every season
Matchpractice_match_historyOne row per player, per match

Every ladder, sidebar, placeholder and menu reads the season tier. The lifetime tier is the permanent record and survives every season rotation, see Seasons. The match tier is the match history.

The global ladder is not a separate table: it is one more row in the same tables, stored under the kit id global. That is what lets one query answer both "top on Sumo" and "top overall".

What a row holds
GroupFields
Resultwins, losses, draws, winRate
Combatkills, deaths, kdr, damageDealt, damageTaken
AccuracyhitsDealt, hitsReceived, totalSwings
CombobestCombo, comboSum, comboSamples
StreakscurrentStreak, bestStreak
Ratingelo, peakElo, lowElo, rankedGamesPlayed
TimetimePlayed, firstMatchAt, lastMatchAt

winRate and kdr are stored, not computed on read, so a leaderboard can order by them in the database.

When a match writes its numbers#

Kills and deaths are recorded as they happen, so a live sidebar and a kill streak stay accurate mid-match. Everything else (the result, damage dealt and taken, hits, swings, best combo and time played) is committed once, when the match ends, as a single delta per player.

A match that is CANCELLED, or that never left the countdown, writes nothing at all.

Damage taken is derived from what the others dealt

There is no separate damage-taken accumulator. Your damage taken is the sum of everybody else's damage dealt in that match, which in a 1v1 is exactly your opponent's output.

Leaderboards#

A player runs /stats, /lb or /leaderboard. The menu opens on the category list, then the kits (the global card is Global stats), then a per-kit leaderboard. Each kit card shows the reader's own rank, LP, position and counters. The leaderboard can be sorted by eleven counters, picked with the buttons along the bottom:

rank, kills, deaths, kdr, wins, losses, win rate, best streak, current streak, damage dealt, time played.

/stats <player> opens somebody else's stats; if they are offline, their UUID is looked up by name. Both commands need exyliapractice.stats, which everyone has by default. See Commands and Permissions.

Leaderboards are cached for 5 minutes and ordered by the database against a season-scoped index. A board that has gone stale is served from the last copy while a fresh one loads in the background, so a menu never blocks on a query. A match result and an admin edit (/epc stats set, add, remove) both clear the cache, so the next time a player opens the board it already shows the change. If a correction seems to have no effect, check that you edited the right kit id (or global) and that you are looking at the current season: lifetime numbers are not touched.

Leaderboard settings and rank text
SettingDefaultWhat it does
leaderboard.max-entries50How many rows a leaderboard holds

On the rank board, each row's value comes from the language's messages.yml, so every part can be coloured (see Colours and Messages and languages):

KeyDefaultUsed for
leaderboard.rank.value%rank% %lp%/%lp_max%A rank with divisions. %rank% is the name and division, %lp% the LP, %lp_max% the division's width, %elo% the ELO.
leaderboard.rank.value-top%rank% %elo%A rank without LP (the top tier). Same placeholders.

The menus themselves are menus/player/leaderboard.yml, stats_category.yml and stats_kit.yml in the language folder; see Edit menus.

Placeholders#

Every counter is available as a placeholder, including %exyliapracticecore_stats_top_<stat>_<position>% for a leaderboard row. See Placeholders and use them in a scoreboard or a hologram.

PlaceholderShowsExample
%exyliapracticecore_stats_kills%The reader's total kills.128
%exyliapracticecore_stats_deaths%Total deaths.96
%exyliapracticecore_stats_kdr%Kill/death ratio, one decimal.1.3
%exyliapracticecore_stats_wins%Wins.40
%exyliapracticecore_stats_losses%Losses.31
%exyliapracticecore_stats_win_rate%Win rate as a percentage.56.3%
%exyliapracticecore_stats_games%Wins plus losses.71
%exyliapracticecore_stats_current_streak%Current win streak.3
%exyliapracticecore_stats_best_streak%Best win streak.9
%exyliapracticecore_stats_damage%Damage dealt, one decimal.1520.5
%exyliapracticecore_stats_time%Time played, formatted.4h 12m

Admin commands#

All of these need exyliapractice.admin and take global in place of a kit id to reach the overall ladder.

CommandWhat it doesPermission
/epc stats get <player> <kit|global> <field>Read one counter. Fields: kills, deaths, wins, losses, elo, best-streak, current-streak, damage, time.exyliapractice.admin
/epc stats set <player> <kit|global> <field> <value>Set a counter to a value.exyliapractice.admin
/epc stats add <player> <kit|global> <field> <amount>Add to a counter.exyliapractice.admin
/epc stats remove <player> <kit|global> <field> <amount>Subtract from a counter.exyliapractice.admin
/epc stats summary <player> <kit|global>Show a formatted overview. In game it opens that player's stats screen, where each counter can be edited.exyliapractice.admin
/epc kits clear <player> <kit> [confirm]Delete a player's saved layouts for one kit. Without confirm it only says what would be cleared.exyliapractice.admin
/epc export [filename]Dump the database to a file. With no name, a timestamped file in the dumps folder.exyliapractice.admin
/epc import <filename>Load a dump back in.exyliapractice.admin
/epc migrate <filename> [--skip-stats]Convert a legacy ExyliaCommons v2 dump into this plugin's format and import it.exyliapractice.admin

The editable fields are:

kills  deaths  wins  losses  elo
best-streak  current-streak  damage  time

best-streak and current-streak also accept beststreak and currentstreak. Every field is clamped at zero: add and remove cannot take a counter negative. time is in milliseconds.

These edit the current season only

The lifetime tier is not touched by stats set or stats add, so a correction to a season row does not rewrite the permanent record.

Bulk operations#

Run /epc, click Data management. Every action asks for confirmation first and none can be undone:

ButtonWhat it does
Clear kit statsDeletes every current-season row for one kit
Clear all statsDeletes every current-season row
Reset kit ELOSets every current-season rating on one kit back to elo.starting-mmr
Reset all ELOThe same for every kit
Clear kit loadoutsDeletes every player's saved loadouts for one kit
Export database / Import databaseA full database dump, through ExyliaLib's transfer module
Player dataOne player's data, see ExyliaLib's /exylialib resetplayer below

To start a fresh competitive period without losing the lifetime record, use New season in the same screen; see Seasons.

Wiping every loadout or the whole match history, and resetting one player, are ExyliaLib's /exylialib wipe and /exylialib resetplayer; see Database.

Something missing on this page? Tell us on Discord