Custom Leaderboards

Leaderboard type

Generate Copy Link Refresh Copy Year Data

How to use

This search tool uses data from speedrun.com to generate custom leaderboards according to various parameters which you can control. There are four leaderboard types:

• Normal Leaderboard: Sorts runs by lowest time, if multiple categories are selected then still sorts by lowest time, including each players' personal best for each category.
• Sum of Best: Sorts by the sum of a player's best times for a set of categories. Note that transition times between levels in TWHG1 and TWHG2 are factored into the calculations of these sums.
• Medal Counts: Sorts by WRs, 2nds and 3rds achieved by each player in a given set of categories. Note that 4ths, 5ths, etc. are also considered in the rankings but not displayed. Note that some columns may add up to more than the number of categories due to WR ties.
• Recent Runs: Sorts runs by most recent. Obsolete runs are included. Useful for seeing the history of a particular category or set of categories

Leaderboards can be generated for a single category or set of categories:

• Single Category: Allows you to select a single category by specifying the game, level (if applicable), category and subcategories (if applicable).
• Multiple Categories: Allows you to select a set of categories. You can include level runs, full-game runs or both. Note that glitchless leaderboards are considered to fall under the "glitched" category where no specific leaderboard for glitched runs exists. Similarly, TWHG1 runs are considered to be "Any%" and "100%", TWHG2 runs are considered "Any%" while TWHG2.1 runs are considered "100%". The reason for these allocations is to align with multiwhg categories.

Other options include:

• Verification Status: Unlike my previous leaderboard designs, you can now view runs that have not been verified. This is useful if you want to see what the leaderboard will look like once all pending runs are verified. To do this, simply tick the "unverified" box. Be warned that unverified runs are frequently illegitimate or inaccurate so leaderboards generated this way are not reliable. Also, there is the option to include rejected runs... if you have some reason to do so.
• Date Range: You have the option to set a date range. Only runs within the date range will be considered when the leaderboard is generated. This is useful for seeing what a leaderboard looked like at some point in the past, or analysing the community activity within a certain window of time.

Buttons:

• Click the Generate button to generate the leaderboard.
• Click the Copy Link button to copy a link to your leaderboard. This link contains all the information about your search parameters and can be shared with others.
• Click the Refresh button to refresh the leaderboard with the current parameters. Refresh the page if you wish to revert to the leaderboard contained in the url. Click "Custom Leaderboards" in the side navigation if you wish to completely reset the leaderboard to default parameters.

Any bugs or suggestions please contact Danicker on discord.

The speedrun.com API documentation can be found here.