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 !stats to open it, !top for the leaderboards, !achievements or !history for 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_announce is 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_days days, 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_keep ended seasons are kept (data/kgx_admin_toolbox/match_seasons.json). The season number is kept in match_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.json and the history in match_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) and KGXAT_MatchEnded (the history entry). The networked value KGXAT_Level holds a player's level, so the HUD token {nw:KGXAT_Level} shows it.

Back to Basics

Type to search every tool, panel, setting, FAQ answer and release.