The purpose of the TagPro Competitive Stats userscript is to save competitive game data for TagPro under STATS, or the Standardized Tracking and Accountability of TagPro Statistics. This is accomplished by providing standardized abbreviations for every single team and sending game data/cap updates for games played with the no-script toggle.
This userscript and the corresponding database of game data are not supported or affiliated with TagPro or KoalaBeast.
Read the full Privacy Policy here.
Note on branches: Master is the branch where bug fixes and enhancements get implemented and tested. Stable is the public version which is currently used by the corresponding gist.
Note: You'll need to download Tampermonkey or other alternative to use this userscript. The link above goes to the corresponding gist of the userscript in this repo, but the two are identical.
Look up your game on the Raw Games sheet and input the id on one of the viewers. You can also switch the format to show seconds for hold/prevent instead of minutes:seconds.
You can also filter games via map, up to 2 team names, server, up to 4 players, and date.
Raw data can also be retrived to submit to TPL. Just copy the cell containing the raw data, paste it into a pastebin, and submit it with the rest of your stats!
This script offers the ability to create custom groups. This is mostly for compatibility with TToC_BOT on the NA TagPro Mumble Server.
Creating custom groups: [SERVER is the TagPro Server, GROUPID is the group identifier if group is setup, MAPNAME is the name of the map]
If you want a regular comp group: http://tagpro-SERVER.koalabeast.com/groups/#cg
If you want a comp group set to a map: http://tagpro-SERVER.koalabeast.com/groups/#cg-MAPNAME
If you have a group setup but want to make it comp: http://tagpro-SERVER.koalabeast.com/groups/GROUPID/#cg
If you have a group setup but want to make it comp with a map: http://tagpro-SERVER.koalabeast.com/groups/GROUPID/#cg-MAPNAME
If you're the group leader, a new option will appear for you underneath the swap teams button.
If you've ever worried about what abbreviations to use in your games, you'll never have to worry again. Just select the league you're playing in at the top, and a nice box will appear allowing you to specify team names.
If you're done setting team names and don't want the boxes to set team names anymore, simply set the league to "None" and the boxes will disappear.
Once you've specified the team names and everyone is in, you're ready to launch the game!
If you're a player, this script will save 7 things before you launch into game: Red Team Name, Blue Team Name, Group ID, Server, Map, Time Limit, and Cap Limit.
When you're in game, this script essentially rips the scoreboard into an array and sends it as you leave the game, along with the stuff that was saved before. It's not fancy like tagpro.eu stats, but it'll get the job done for now.
If you're using custom team names, the script will also send cap updates, which allows for live score tickers to be implemented by each league.
So other than making sure the scoreboard is open when you leave the game (and assuming you leave when the game ends that already happens,) you don't have to do anything special in game to make sure stuff gets sent!
If you are viewing a no-script game in spectator mode, you will also be able to send stats and cap updates through this script. In addition, if a team has corresponding jerseys, this script will show them as well while you are watching the game. (You can disable jerseys or jersey spin in the options if needed.)
This script imports two jsons in order to provide accurate information for players.
teams.json holds information about each team and the corresponding abbreviation. It is formatted as a json object where each league is a property. Each league contains the same number of objects as divisions in the league, with division names as the properties. These objects will then have the full team name as the property and the team abbreviation as the value.
In addition, there is a Leagues property which contains the list of all leagues in the json. This is used to populate the autoscore league selector at the top of the group page. Similar to each league, this is also split into "divisions" to distinguish each league. However, league names are stored in arrays instead of properties since there is no further information needed.
For example:
{
"Leagues": { // League list split into 3 "Divisions"
"NA Competitive": ["NFTL-A", "NFTL-B", "US Contenders"], // array containing league names
"NA Tournaments": ["TToC", "RCL", "CLTP", "Pipberry"],
"EU Competitive": ["ELTP Majors", "ELTP Minors"]
},
"NFTL-A": { // League
"Radius": { // Division
"Au Neutral": "TAUN", // Individual Team
"Gate Keepers": "TGTK",
"Rutabaga": "TRTB",
"Spike and Subscribe": "TSAS",
"The Neutralizers": "TTNT"
},
"Pi": { // Second Division
"Baoting with Babish": "TBWB" // Individual Team
},
"Origin": { // Third Division
"Ball n Large": "TBNL", // Individual Team
"Wait Wait Don't Tag Me": "TWDT",
"Wolves of Ball Street": "TWBS"
},
"Centra": { // Fourth Division
"877-CAPSNOW": "T877", // Individual Team
"Land After Manips": "TLAM",
"Respawnsiballs": "TRSP"
}
}
// continue leagues after
}jerseys.json holds the raw imgur IDs for the jerseys of each team. It is formatted as a json object where each team abbreviation is a property. Abbreviations are sorted alphabetically, with the exception of NLTP (with league identifiers A and B) because league rules mandate the same abbreviation for both teams. Each abbreviation contains a single array with two strings and four numbers corresponding to the raw imgur IDs of the jerseys and the transparency of each jersey. The first string is the red jersey and the second string is the blue jersey. The first number corresponds to the transparency of the actual ball with the red jersey and the second number corresponds to the transparency of the actual ball with the blue jersey. The third number corresponds to the transparency of the red jersey and the second number corresponds to the transparency of the blue jersey. 1 is the default value while 0 is fully transparent.
For example:
{
"MGGB": ["TAMY9Ur", // imgur ID for red jersey
"vFE57qK", // imgur ID for blue jersey
1, // transparency of ball with red jersey
1, // transparency of ball with blue jersey
1, // transparency of jersey with red jersey
1], // transparency of jersey with blue jersey
"MPIC": ["oEGw0Ql", "xIyWZ5w", 1, 1, 1, 1],
"MCRK": ["pxYvTOi", "akr6qGR", 1, 1, 1, 1]
// continue teams after
}customMaps.json allows for the creation of custom map lists mapped with their respective map ID on unfortunate maps. It is formatted as a JSON object where each map list is a property. Map lists are sorted alphabetically and will show up at the bottom of the map selector in the groups page. The map list itself is an array of JSON objects, where each index represents one map and its id. The order of the maps in the array matters, as the script will display maps in the same order on the group page.
For example:
{
"MMTC": [ // name for the map list
{
"name":"Transilio 2020", // name of map
"mapID":67148 // id of map on unfortunate maps
},
{
"name":"Haste",
"mapID":67237
}
// continue maps after
] // add more lists as needed
}For detailed changes prior to v0.30, check here.
V0.01 (12/17/2017)- Updated Destar's private group scripts to toggle no-script and accept maps as an argument
V0.1 (12/17/2017)- Added update/download URLs to the script
V0.1a (12/18/2017)- Changed structure of non-standard map selection
V0.11 (12/18/2017)- Added ability to set Autoscore abbreviations
v0.12 (12/20/2017)- Changed leader conditions, added labels to easily identify leagues, and added the ability to manually submit stats
v0.13 (12/20/2017)- General script cleanup, changed leader conditions, and improved onChange detection for team names
v0.14 (12/20/2017)- General script cleanup
v0.15 (12/20/2017)- Removed debug language from script testing
v0.15a (12/20/2017)- Changed label to "Competitive Group" on the main page
v0.16 (12/20/2017)- Added non-leader support for saving team names
v0.16a (12/20/2017)- Changed leader conditions
v0.17 (12/20/2017)- Changed leader conditions
V0.18 (03/04/2018)- Added function to send data automatically before exiting game, added game data
V0.19 (03/06/2018)- Added variables to help identify when the game has ended and help differentiate game data, disabled sending cap updates until infrastructure is set up
V0.20 (unreleased)- Added ELTP/OLTP team abbreviations, enabled cap updates
V0.21 (03/22/2018)- Added functions to calculate cap updates based off sound events, improved overall functionality of code
V0.22 (03/25/2018)- fixed 0 startTime bug because some people apparently like playing with sounds off
V0.23 (03/29/2018)- fixed player bug relating to the group socket 'play' event
V0.24 (04/13/2018)- updated MLTP team abbreviations to S15
V0.25 (04/28/2018)- updated NLTP team abbreviations to S12, restructured cap update conditions
v0.26 (05/01/2018)- "BDL update", changed the default behavior of the abbreviations list to a blank option instead of the first abbreviation
v0.27 (05/23/2018)- "#Update", fixed a bug where certain special characters would prevent stats from submitting properly
v0.28 (08/04/2018)- updated MLTP team abbreviations to S16, fixed default group bug, restructured abbreviations in the group page, userscript now sends a cap update at the beginning of the game
v0.29 (08/05/2018)- "Destar's QoL update", added the option to disable the abbreviation selector under team names by selecting the "None" option in the league selector
v0.30 (08/12/2018)- Added a spectator mode and corresponding checks, fixed passing map names through URL, updated NLTP abbreviations to S13, changed default nature of tournament groups created using #tg, cleaned up in game functions, restructured update conditions for stats table, restructured various functions, restructured group identifier conditions
v0.31 (08/16/2018)- Changed format of abbreviations, added jerseys to Spectator mode, fix spacing bug, fix 0-0 score update bug, extend time before first score update, general cleanup
v0.32 (08/17/2018)- Added the ability to customize transparency values for jerseys
v0.33 (09/01/2018)- Changed detection method for group functions, removed all usage of JQuery, added more information to cap updates, fixed bug where name spacing was incorrect, fixed bug where game data did not match between player and spectator, added general identification to cap updates/stats for fraud mitigation, general design updates, general cleanup and optimization
v0.34 (09/01/2018)- Fixed a group bug where leader status is not properly established by the groupReady function
v0.35 (09/12/2018)- Removed direct group creation link, removed groupLeader functions, general cleanup
v0.36 (09/30/2018)- Refactored code to allow change between leader/spectator, increased timout time for group functions, added ability to save game data locally, fixed cap update spam bug, reimplement checkLeader function, added ability to show update notes in group, officially added privacy policy
v0.37 (10/11/2018)- Restructured group leader checking, restructured checking if group matches comp state, added a notification which shows if abbreviations aren't set and group matches comp state, added option to enable/disable abbreviation checks, restructured cap updates/final stats submissions, restructured local export json, added a refresh check to allow script to run when user refreshes in game, league selector is now hidden if group is a pub group, general cleanup
v0.3701 (12/20/2018)- Emergency update to fix group bug of death on new test servers
v0.38 (unreleased)- Change structure of teams.json, add support for the tagpro test servers, fix public group launch bug, general cleanup
v0.39 (2/5/2019)- Add check to change in game muted sounds to volume "0", add options to enable/disable sound checks, standardize start time of match by matching with Analytics collector, reduce tournament team abbrs to 16, remove ability to define tournament groups with #tg, delay display of update notes when script is updated, general cleanup
v0.40 (5/13/2019)- Update include clause to match updated TagPro URL, change Update/Download URL to point to GitHub Repo, update Tournament Abbreviations, change url of teams.json to point to proper location, general cleanup
v0.41 (1/11/2020)- Overtime is off by default in comp groups, added ability to set custom map lists, updated comp check functions to support overtime, added new custom option to support H2 overtime
v0.42 (5/4/2021)- Fix overtime defaults to be in line with dev changes from TPFG Update 6, update backscore to prepare for backend refresh