- I made sure my file(s) follow the Submissions Guidelines
- Yes
StatTracker : Multiplayer Time Records, ELO, and Skin/Map Usage data suite
For server owners with a limited amount of character slots and custom map pool, it's important to know what content your players are actually using and enjoy. StatTracker aims to record data to allow you to review what is and what isn't popular, on top of providing data backed features to add to the player experience.
All data is saved to the server's luafiles folder, letting owners view data from inside and outside of the game.
v2.1 - Scorekeeper has been integrated into StatTracker
There is no longer a need to run both of these addons at the same time.
Important setup note!
Make sure StatTracker is loaded after your load your game mode mods, and make sure those game mode mods are always loaded on the server. StatTracker will lose data for those modes if these steps are not followed!
What data is saved?
- Number of races, and 1st, 2nd, and 3rd place finishes
- KartScore, an ELO system, with split data categories for Vanilla races, Juicebox races, DriftNitro races, Elimination races, and Combi races
- The player's total accumulated score while playing on the server (Scorekeeper)
- A record of character use for each player
- How many times they've landed hits with items, and how many times they've been spun out, exploded, squished, or hit themselves/hit a map hazard
- An estimated total playtime on the server (in game data only)
- Number of completed races
- An RTV total, marking incomplete races skipped by server owner intervention, or by Hostmod vote.
- Map record times, with split records for Vanilla races, Juicebox races, and DriftNitro races. Record times also note the player's name and current skin for display on the game HUD.
- Total number of races a character was used in.
- A "weighted" number of uses, to prevent one player's heavy use of one character from skewing perception of how popular a character may actually be.
There are no addon dependencies, but StatTracker takes into consideration a couple of different addons right out of the box. Find more information about specific addons and console commands further down.
For players, some data is displayed directly on the game HUD -
Server record map time
A new record time popup after the race is over (with the character's power item sound clip!)
Changes to the player's KartScore (ELO system) at the end of the race
StatTracker.cfg is created in the player's luafiles folder with commands that lets them hide any of these features.
Strongly Recommended
Hostmod - While not required, the ability for players to vote skip maps is a very strong indicator of what maps they absolutely dread playing. It's also an incredible tool overall, allowing the ability to host multiple game type addons on one server, which StatTracker can take into consideration.
Well Supported
Juicebox and DriftNitro - These mods dramatically change the flow of the game, and as such, have separated track record and KartScore categories in the recorded data.
Elimination and Combi - These modes have KartScore, but do not support record times at the moment.
Reduced Data Recording Capabilities
These addons modify the in game timer, so by default they do not record KartScore or a map's record time.
Please shoot me a message via Discord (Montblanc#2569) if you are using an addon not listed here that alters the in game timer. Map records will be corrupted if StatTracker encounters one it does not recognize.
Hostmod - While not required, the ability for players to vote skip maps is a very strong indicator of what maps they absolutely dread playing. It's also an incredible tool overall, allowing the ability to host multiple game type addons on one server, which StatTracker can take into consideration.
Well Supported
Juicebox and DriftNitro - These mods dramatically change the flow of the game, and as such, have separated track record and KartScore categories in the recorded data.
Elimination and Combi - These modes have KartScore, but do not support record times at the moment.
Reduced Data Recording Capabilities
These addons modify the in game timer, so by default they do not record KartScore or a map's record time.
Please shoot me a message via Discord (Montblanc#2569) if you are using an addon not listed here that alters the in game timer. Map records will be corrupted if StatTracker encounters one it does not recognize.
- Default Battle mode, and Battle Plus
- FriendMod
- Frontrun
- SPB Attack (it's on Hostmod's page)
Admin Only
- st_enabled
- Enables/Disables all LUA hook functions of StatTracker
- 1 - on (default), 0 - off
- Enables/Disables all LUA hook functions of StatTracker
- st_enableks
- Enables/Disables the KartScore functions of StatTracker
- 1 - on (default), 0 - off
- Enables/Disables the KartScore functions of StatTracker
- st_enablerecords
- Enables/Disables the map record functions of StatTracker
- 1 - on (default), 0 - off
- Enables/Disables the map record functions of StatTracker
- st_silentmode
- Determines the level of StatTracker visibility to players
- 0 - all elements visible (default)
- 1 - HUD elements are forced hidden
- 2 - HUD elements are forced hidden, and players are unable to use in game console commands to see data.
- Determines the level of StatTracker visibility to players
- st_wiperemovedaddons
- Prevents the once per server restart data maintenance from deleting data related to content that has since been removed from the server
- 0 (default) - No data is deleted during maintenance
- 1 - References to removed skins & maps are scrubbed from the data files during maintenance
- Prevents the once per server restart data maintenance from deleting data related to content that has since been removed from the server
- st_clearmaprecord
- Wipes time records for the specified map
- Usage : st_clearmaprecord MAPXX
- The deletions are made instantly, make sure not to typo the map ID.
- sk_setscore
- Manually sets a player's score to the specified total
- Usage: sk_setscore "Player Name" 999
- Target player must be in game for this to work
- st_enableskintracking
- Enables/Disables skin tracking functions
- 1 - on (default), 0 - off
- This disables saving of Skincounter.txt and pSkinUse.txt
- Enables/Disables skin tracking functions
- st_enablemapcounttracking
- Enables/Disables map play count tracking
- 1 - on (default), 0 - off
- This disables saving of Mapdata.txt, not time records.
- Enables/Disables map play count tracking
- st_enabletimerecordtracking
- Enables/Disables map time record tracking
- 1 - on (default), 0 - off
- This disables saving of EasyRecords.txt & NormalRecords.txt & HardRecords.txt
- Enables/Disables map time record tracking
- st_enableplayertracking
- Enables/Disables player data tracking
- 1 - on (default), 0 - off
- This disables saving of Playerdata.txt
- Enables/Disables player data tracking
- st_enablescorekeeper
- Enables/Disables scorekeeper functionality
- 1 - on (default), 0 - off
- This disables saving of scorekeeper.txt
- Enables/Disables scorekeeper functionality
- st_recordpopup
- Shows/Hides the new record time popup at the end of a race.
- 1 - on (default), 0 - off
- This command is available in the generated stattracker.cfg file
- Shows/Hides the new record time popup at the end of a race.
- st_showks
- Shows/Hides KartScore updates at the end of a race
- 1 - on (default), 0 - off
- This command is available in the generated stattracker.cfg file
- Shows/Hides KartScore updates at the end of a race
- st_showtime
- Shows/Hides the map record time under the current race time.
- 1 - on (default), 0 - off
- This command is available in the generated stattracker.cfg file
- Shows/Hides the map record time under the current race time.
- st_recordsound
- Toggles skin gloat sounds that play when a new time record is achieved.
- 1 - on (default), 0 - off
- Toggles skin gloat sounds that play when a new time record is achieved.
- st_playerdata [player name or command]
- In game lookup command to find player data.
- All available uses:
- st_playerdata
- Displays the requesting player's data on the server
- st_playerdata [player name]
- Displays the entered player's data on the server
- st_playerdata lobby
- Lists each player currently playing, their KartScore, and their total wins
- st_playerdata top
- Shows a top 10 list of all players with the most race wins
- st_playerdata top ks
- Shows a top 10 list of all players with the highest KartScore in the current mode
- st_playerdata
- st_mapdata [map code or command]
- In game lookup command to find map data
- All available uses:
- st_mapdata
- Displays plays, RTVs, and map records for the current map
- st_mapdata [map code]
- Displays plays, RTVs, and map records for the requested map ID
- st_mapdata top
- Displays a top 10 list of the most played maps
- st_mapdata bottom
- Displays a top 10 list of the most RTV'd maps
- st_skindata [skin ID or command]
- In game look command to find character data
- All available uses:
- st_skindata
- Displays weighted uses, total uses, and requesting player uses of the character the requesting player is currently using
- st_skindata [skin ID]
- Displays weighted uses, total uses, and requesting player uses of the character requested by ID
- st_skindata top
- Displays a top 10 list of the most used characters based on weighted uses.
- st_skindata
All column names are in order from left to right.
Playerdata.txt
Playerdata.txt
- Player Name
- Maps Played
- Wins
- Item Hits
- Self Hits/Environmental Hits
- Times Spun Out
- Times Exploded
- Times Squished
- Second Places
- Third Places
- KartScore
- Juicebox KartScore
- DriftNitro KartScore
- Elimination KartScore
- Combi KartScore
- Map ID
- Times Played
- RTV Count
- Full Map Name
- Internal Skin Name
- Weighted Uses
- Full Skin Name
- Total Uses
- Map ID
- Record Time (in game realtime variable)
- Record holding player name
- Record holding skin
- Juicebox Record Time
- Juicebox player name
- Juicebox record skin
- DriftNitro Record Time
- DriftNitro player name
- DriftNitro record skin
- Player Name
- Condensed skin use format
- [internal skin ID] / [number of uses] |
- EX: internal_skin_name/500|other_skin_name/123
