README.md

⚠️ This is alpha experimental software, use at your own risk!

About

This is a quick script created to generate a compatible cardtier.json for use with the macOS version of HSTracker, using HSReplay arena card stats.

• It requires no changes to HSTracker itself
• It always pulls fresh data when you run the script
• It looks at HSReplay class-specific data

Usage

tl;dr

With required dependencies installed (git, latest node)

git clone git@github.com:jdb8/hstracker-hsreplay-stats.git
cd hstracker-hsreplay-stats
npm install
node index.mjs
ln -sf "$PWD/cardtier.json" "/Users/$USER/Library/Application Support/HSTracker/arena"

More details

1. Clone or download this repo
2. Install latest node
3. cd into the cloned repo and install dependencies with npm install
4. Run node index.mjs to pull latest arena stat info and create a local cardtier.json file
5. (optional) back up your existing cardtier.json inside /Users/$USER/Library/Application Support/HSTracker/arena
6. Copy the cardtier.json file into /Users/$USER/Library/Application Support/HSTracker/arena, or symlink it for convenience
7. Restart HSTracker

The newly-generated cardtier.json will now be used by HSTracker to display "deck winrate" in place of arena tierlist score.

Limitations

Due to the way HSTracker currently displays scores, the deck winrates currently are displayed multipled by 10. For example, if a card has a deck winrate of 62.1%, HSTracker will display this as a "score" of 621.

Example:

Live DH data puts these cards at 59.1%, 58.3%, and 52.2% (but be careful of the sample size, which isn't displayed! Use your best judgement).

Future functionality

• automatically detect when new patches/expansions are released to avoid need to manually update CURRENT_PATCH -> CURRENT_EXPANSION and vice versa
• support for played winrate or other stats
• support for displaying played count to highlight low sample sizes
• package this up to a single binary so it's easier to run without a bunch of steps