Tutorial / Basics
Match Stats and Progression
XP, levels, achievements, leaderboards, the match history and the name colors, badges and trails you unlock by playing Game Modes matches.
What it does
Every Game Modes match that counts gives the players in it XP and adds to their stats: matches played and won, rounds, kills, deaths, score, time played, and the same per mode. XP raises your level (up to 100). Achievements unlock as you play, and levels and achievements unlock cosmetics: name colors, badges and trails.
The server keeps a history of the last matches (who played, the result, each player's score and XP) and leaderboards for every stat, overall or per mode.
A match counts when it ends by its own rules (not ended early by an admin) with at least kgxat_stats_min_players players in it (2 by default; bots do not count) and at least one round played. Players still in the match when it ends get its totals and XP. Things that happen during a match (a captured flag, a kill streak, a round won as a traitor) count right away.
Where to find it
- F3 > Match stats (the server hub). Type
!statsto open it,!topfor the leaderboards,!achievementsor!historyfor those tabs. - When the hub is off, the same commands open a Match stats window. Client console:
kgxat_stats [me|top|history|ach|cosmetics]. - Settings: Q menu > KGX's Admin Toolbox > Utilities > Game Modes, at the bottom (superadmins change them).
The Match stats tabs
| Tab | What it shows |
|---|---|
| My stats | Your level and the XP to the next one, your totals (matches and rounds played / won, kills / deaths and K/D, score, best kill streak, time in matches, achievements, first and last match) and a row per mode. Another player's stats show here when you open them from the leaderboards; Back to my stats returns. |
| Leaderboards | The top 50 for a stat: Level (XP), Matches won, Matches played, Kills, Kills per death (10 kills or more), Rounds won, Best match score, Best kill streak, Achievements, Time in matches. Most can be narrowed to one mode. Your own rank is shown under the list. Double-click a player to see their stats. v3.6.14: the third box picks All time, Season N (now) or an ended season (its top 25). |
| History | The last matches: when, mode, result, map, rounds, length and players. "(did not count)" marks matches that gave no stats. Click a match to see each player's team, score, kills, deaths, rounds won, whether they won and the XP they got. |
| Achievements | Every achievement with its progress, or the date you got it, and the badge it unlocks. |
| Cosmetics | Name colors, badges and trails: what is unlocked, what is locked and how to unlock it. Click one to wear it; None takes it off. |
During and after a match:
- The match scoreboard and the final standings show each player's level before their name, their name color and their badge after it. The final standings also show the XP each player got.
- After a match that counts, a box shows the XP you got and your progress to the next level.
- Level-ups and achievements pop up at the top of your screen and, when
kgxat_stats_announceis on, are announced in chat. - In free-for-all modes the kill feed shows names in their name color; team modes keep the team colors.
XP and levels
| Part of a match | XP |
|---|---|
| Finishing a match | 20 |
| Each round played | 10 |
| Each round won (your team, your side or you) | 15 |
| Each kill of a player (up to 60 a match; bots do not count) | 2 |
| Each objective (flag capture, capture point, bomb planted or defused; up to 20 a match) | 5 |
| Winning the match | 50 |
| Each achievement | 50 |
The server's XP rate (kgxat_stats_xp, in percent) scales all of it. Level L takes 50 x (L - 1) x L XP in total: level 2 at 100 XP, level 5 at 1,000, level 10 at 4,500, level 50 at 122,500, level 100 at 495,000.
Achievements
| Achievement | How | Badge |
|---|---|---|
| First Match / Regular / Veteran | Finish 1 / 25 / 100 matches | Regular, Veteran |
| First Win / Champion / Legend | Win 1 / 10 / 50 matches | Champion, Legend |
| Hunter / Slayer | 100 / 1,000 kills | Hunter, Slayer |
| Rampage / Unstoppable | 5 / 10 kills in a row without dying | Rampage, Unstoppable |
| Flawless | Win a match without dying | Flawless |
| All-Rounder | Finish matches in 5 different modes | All-Rounder |
| Star Player | Be the best player of 10 rounds | Star |
| Flag Runner | Capture 10 flags | Flag Runner |
| Conqueror | Help capture 25 capture points | Conqueror |
| Bomb Squad | Plant or defuse 10 bombs | Bomb Squad |
| Gun Master / Titan / Speed Demon | Win a Gun Game / Juggernaut / Race match | Gun Master, Titan, Racer |
| Duelist | Win 3 Duels matches | Duelist |
| Giant Slayer | Kill the Juggernaut 10 times | Giant Slayer |
| Last Survivor | Win 5 Infection rounds as a survivor | Survivor |
| Backstabber / Sleuth / Killer Instinct | Win 5 rounds as a traitor / 5 as a detective / 3 as the murderer | Traitor, Detective, Murderer |
| Master of Disguise / Bloodhound | Win 10 rounds on the hiding / hunting team (Prop Hunt, Hide and Seek, Freeze Tag) | Hidden, Seeker |
| Level 10 / 25 / 50 | Reach the level | Elite (25), Master (50) |
Who wins the match, for stats:
- Team modes: every player of the team with the most rounds won.
- Free for all: the player with the most rounds won.
- Hidden-role modes, Infection and the hiding modes (sides change between rounds): everyone tied with the most rounds won.
- A draw has no winner, and you must have played at least half of the rounds to get the win.
| Season Champion | End a season with the most XP (v3.6.14) | Season Champion | | Podium | End a season in the top 3 for XP (v3.6.14) | Podium |
Seasons
v3.6.14. Leaderboards have seasons on top of the all-time boards:
- This season counts only the matches of the season: XP earned, matches played and won, kills, K/D, rounds won and time. Best score, best streak and achievements are all-time only; picking them for a season shows the season XP.
- When a season ends, its top 25 of each board are archived, the player with the most season XP gets Season Champion and the top three Podium, chat announces the champion, and the season counts start again. Levels, achievements and cosmetics are never reset by a season.
- A season ends after
kgxat_stats_season_daysdays, or when a superadmin presses End the season... above the leaderboards. With 0 days it only ends that way. A season nobody played in is not archived; it just starts again. kgxat_stats_season_keepended seasons are kept (data/kgx_admin_toolbox/match_seasons.json). The season number is kept inmatch_stats.json; the first season starts when the server first runs v3.6.14.- My stats shows your XP, matches and wins this season.
Cosmetics
| Kind | Unlocks |
|---|---|
| Name colors | Sky (level 3), Mint (6), Gold (10), Orange (15), Pink (20), Violet (30), Crimson (40); Ice (Flawless), Emerald (Champion), Royal (Legend) |
| Badges | One for most achievements (see the table above) |
| Trails | Smoke (level 5), Plasma (10), Tube (15), Laser (20), Electric (30), Physics beam (40); Hearts (Legend), LOL (Veteran) |
Trails take your name color. kgxat_stats_trails sets when they show: 0 = never, 1 = while you play a match (default), 2 = always. They never show in hiding modes (Prop Hunt, Hide and Seek, Freeze Tag) or hidden-role modes (Traitors, Murder), on cloaked players, or on players who are dead, out or waiting.
Settings
| Setting | What it does | Default |
|---|---|---|
| Match stats: XP, levels, achievements, history | kgxat_stats_on. Off: nothing is recorded and the hub tab is hidden. |
On |
| Announce level-ups and achievements in chat | kgxat_stats_announce |
On |
| Show levels, name colors and badges | kgxat_stats_cosmetics (match scoreboard, kill feed, final standings) |
On |
| Players (not bots) a match needs to count | kgxat_stats_min_players, 1-32 |
2 |
| XP rate (%, 100 = normal) | kgxat_stats_xp, 0-1000 |
100 |
| Matches kept in the history | kgxat_stats_history, 0-200 |
50 |
| Trails: 0 off, 1 during matches, 2 always | kgxat_stats_trails |
1 |
| Season length in days (0 = a superadmin ends it) | kgxat_stats_season_days, 0-365 (v3.6.14) |
0 |
| Ended seasons kept | kgxat_stats_season_keep, 1-50 |
12 |
Superadmins also get, in Match stats: right-click a player on the Leaderboards > Reset this player's stats..., End the season... and Reset everyone's stats... above the leaderboard, and Clear the match history... on the History tab. Each asks first and is written to the action log.
Tips and limits
- Stats are saved in
data/kgx_admin_toolbox/match_stats.jsonand the history inmatch_history.json, both for every map. They are part of Backup / Restore like the rest of the toolbox data. - Set Players a match needs to 1 to let a match with one player count, for example to test it.
- A player who leaves before the end of a match keeps what they earned during it (achievements, streaks, captures) but gets no totals or XP for it. Leaving and joining the same match again keeps your kills, deaths and rounds.
- Kills of your own team or side are no kills. Any death ends a kill streak.
- Lua:
hook.Add("KGXAT_StatsLevelUp", ...)(ply, level),KGXAT_StatsAchievement(ply, id) andKGXAT_MatchEnded(the history entry). The networked valueKGXAT_Levelholds a player's level, so the HUD token{nw:KGXAT_Level}shows it.