daniellav/hots-party-stats

This project turns your local replay files from Heroes of the Storm, a team based video game, into a dashboard showing win rates and statistics for you and your regular group of teammates. It looks specifically at games where several named members of your group played on the same team, automatically filtering out solo matches or games with random strangers, though it can be set up to track solo play instead if that is what someone prefers. To use it, a person needs Python installed on a Windows or Mac computer, along with a specific library that Blizzard, the maker of the game, provides for reading replay files. The setup process involves cloning the project, creating an isolated Python environment, and installing the required packages, all done through the command line. Before running anything, the user must edit a configuration file to list the battletags, the in-game usernames, of everyone in their group, along with optional nicer display names and any alternate accounts that should be counted as the same person. The tool comes with placeholder example data so the dashboard can be tried out immediately before anyone plugs in their real group. Once configured, two scripts do the work: one scans every local replay file and writes the results to spreadsheet style data files, and the second reads those files and generates a single self-contained webpage showing the dashboard. That webpage can simply be opened by double-clicking it, no separate web server needed for most of its features. The dashboard includes several tabs covering overall stats, awards, hero talent choices, and graphs, plus a special Fearless mode inspired by competitive drafting rules, where a hero cannot be picked twice across a real-time series of games. That one feature does need a small server running locally or online so that hero picks stay in sync for everyone watching the same series live. Because the tool always determines a group's "team" the same way regardless of who runs it, teammates can each generate their own data and merge it together safely, building a shared history of games without anyone's results overwriting another's.