Destiny 2 Character Stats

This repository contains an up-to-date (usually) collection of ability cooldowns as well as other benefits that character stats provide which can be easily parsed by 3rd party applications. This also includes support for Aspects and Exotics changing the base cooldowns of certain abilities among other things.

All the data stored here is intended for use by 3rd party apps willing to implement them in place of Bungie's own outdated and incomplete information on Character Stats. This includes cooldown times as well as every other kind of useful information that is available from community research.

Disclaimer

• Cooldown times might be ~1 second off in some instances due to how these numbers are calculated. There's really nothing that can be done about it due to the ungodly workload that would be required to maintain this database by manually checking cooldown times at each tier for each ability. (This does not apply to Base (T3) Cooldowns, inaccuracies with those are not acceptable)
• While cooldowns are displayed with rounding to 2 decimal places for improved accuracy when combining them with Overrides, I strongly recommend rounding to a whole number when displaying them.

Report Issues/Inaccuracies

If you notice any inaccuracies in the dataset, feel free to file an issue in the Issues tab and fill out the template. Otherwise, feel free to contact me on Discord @starglance (Stardust) as well. You can also find me in the DIM, Clarity, and Massive Breakdowns Discord servers.

Crediting and Usage Policy

Do NOT claim to be the creator/curator of this database or its contents. This includes purposefully showing the data in a way that leads people to think you may be the maintainer of this data.

That's really about it, I don't ask for anything else. As long as you don't break that rule, please feel free to use whatever info is stored here for your projects.

Though, I would certainly appreciate it if you linked back to this repository and to Clarity's Ko-Fi page. But it's not required so it's entirely up to you.

Recommended Access Paths

• JSON schema for the database with documentation: https://github.com/Database-Clarity/Character-Stats/blob/master/schema.json
• Main Database contents:
  • With Indentation (human-readable): https://Database-Clarity.github.io/Character-Stats/versions/[schemaVersion]/CharacterStatInfo.json
  • Without Indentation (smaller file size): https://Database-Clarity.github.io/Character-Stats/versions/[schemaVersion]/CharacterStatInfo-NI.json
• Versioning using the update.json file found here: https://Database-Clarity.github.io/Character-Stats/update.json

Database Information

Vital information about the database structure and what each property stored in it represents can be found in the shema.json file here.

In addition to the main database files, the update.json contains the following two values:

• lastUpdate - integer: timestamp of the last update made to the database
• schemaVersion - string (matches ^\d+\.\d+$): the current schema version used for this database

Example usage the update.json file for handling breaking changes:

1. The app developer stores the schemaVersion property during implementation to use it for checks
2. When accessing the update.json file to check if there is new information available, the app detects that the current schemaVersion does not match the version stored in the app's code
   • Here, the app developer can choose to display an alert informing the user that the app might be displaying outdated information.
3. Until the developer updates their implementation to support the new schema, the app can still access the old version's files by using the coded-in schemaVersion as in the database URLs

Credits

I want to thank Hugo for their amazing spreadsheet which provided the fundamentals of this database and u/Crystic_Knight for their breakdown of Mobility.