Statistics
What ExyliaPracticeCore counts, when a match writes its numbers, how the leaderboards are built and how to correct a player's stats.
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#
| Tier | Table | Scope |
|---|---|---|
| Season | practice_player_season_stats | One row per player, per kit, per season |
| Lifetime | practice_player_lifetime_stats | One row per player, per kit, across every season |
| Match | practice_match_history | One 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
| Group | Fields |
|---|---|
| Result | wins, losses, draws, winRate |
| Combat | kills, deaths, kdr, damageDealt, damageTaken |
| Accuracy | hitsDealt, hitsReceived, totalSwings |
| Combo | bestCombo, comboSum, comboSamples |
| Streaks | currentStreak, bestStreak |
| Rating | elo, peakElo, lowElo, rankedGamesPlayed |
| Time | timePlayed, 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.
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
| Setting | Default | What it does |
|---|---|---|
leaderboard.max-entries | 50 | How 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):
| Key | Default | Used 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.
| Placeholder | Shows | Example |
|---|---|---|
%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.
| Command | What it does | Permission |
|---|---|---|
/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 timebest-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.
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:
| Button | What it does |
|---|---|
| Clear kit stats | Deletes every current-season row for one kit |
| Clear all stats | Deletes every current-season row |
| Reset kit ELO | Sets every current-season rating on one kit back to elo.starting-mmr |
| Reset all ELO | The same for every kit |
| Clear kit loadouts | Deletes every player's saved loadouts for one kit |
| Export database / Import database | A full database dump, through ExyliaLib's transfer module |
| Player data | One 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