Bring Hearthstone into chat.

1. Enable the feature and choose a player

Sign in with Twitch, enable the Hearthstone plugin in your bot settings, then open Hearthstone settings. Enable Hearthstone there and set Default player to the Battle.net display name you use on the leaderboards.

!db PlayerName reads the public rank cache without a Blizzard key. !rankprogress starts from the next stream’s opening snapshot. Players missing from our cache cannot be tracked yet.

2. Share your live deck with HDT

Install Hearthstone Deck Tracker on your Windows gaming PC. In Hearthstone settings, choose Download Windows setup, then run McBotemSetup.exe.

Setup installs and enables the companion and opens your browser. Match the displayed code, sign in with Twitch, choose your channel and approve the connection. The channel Owner or a Super Mod can approve it. Connection details are saved automatically for your Windows account.

Select a deck in HDT and check that the dashboard shows Connected and a recently synced deck. Then try !deck in chat. Setup can start HDT when you sign in to Windows; you can change that checkbox at any time. Updates are checked automatically and take effect on the next HDT launch.

If Hearthstone is running, setup waits for your game to close before finishing installation. Disconnect a tracker in the dashboard to revoke its access; reconnect from the McBotem Hearthstone app. Advanced manual configuration remains available.

This preview installer is unsigned, so Windows may show a publisher warning. Version 1.2 was tested with HDT 1.53.1 on Windows 11. It syncs selected decks; it does not capture Battlegrounds match results or equipped trinkets.

On an Apple Silicon Mac

Install HSTracker for macOS, then choose Download Mac · Apple Silicon in Hearthstone settings. Unzip the download, move McBotem Hearthstone to Applications, open it and choose Connect channel. Match the code in your browser and approve your channel.

Keep both HSTracker and the companion running. Your selected deck is read locally and connection credentials stay in macOS Keychain. The Mac app requires macOS 12 or newer, is signed by Scarcrux LLC and notarized by Apple, and uses manual updates. Windows setup and its plugin DLL cannot be used on macOS.

Mac version 1.2 imports completed solo and Duos games and records Battlegrounds replay events while running. Check Battlegrounds history in Hearthstone settings, then choose Watch replay for captured games. Scrub through visible boards, attacks and stats; incomplete recordings explain missing coverage. Recordings are kept without a 20-game cutoff. New recordings are public by default for installed bot or paired tracker channels; turn sharing off in Hearthstone settings to keep them private. Older private recordings need a separate publish action. Older summaries cannot recover unrecorded gameplay. Results appear after HSTracker saves the match; !bglast reports the latest result and a viewer replay link when available. While BG mode is detected, !deck explains that there is no constructed deck for the current game.

Standard replay links · Mac 1.3

Enable Allow HSReplay links in !lastgame and !replay in Hearthstone settings to share Standard uploads. This is off by default. Keep HSTracker and the Mac companion open while playing; only completed games safely bound to the live account are imported. Saved deck history without that binding is not backfilled. Windows Standard result sync is not implemented yet.

!lastgame and !replay show the newest recorded Standard or BG result. Standard links appear after HSTracker confirms its upload, never by substituting an older replay. They open HSReplay directly, not HSGuru or McBotem playback; external availability and retention are not guaranteed, and those external replays are not archived in McBotem’s R2. No HSReplay credentials are used and no automatic chat announcements are sent. Turning this off hides bot links but cannot revoke provider URLs already copied. BG keeps McBotem’s own player.

3. Add cards, news and timers

For !hscard, the channel owner adds a Blizzard client ID and secret in Hearthstone settings. For news or jokes, open Timers and choose the Hearthstone news or joke message source.

News checks default to every five minutes while live. The first check establishes a baseline; only new articles are announced after that. Joke timers default to once an hour while live, with five chat messages required in the preceding five minutes.

4. Explore persistent player history

Public rank/rating observations are collected for Standard, Wild, solo Battlegrounds, Duos and Arena. Player history shows daily/weekly summaries and best observed standings in the current season without a Blizzard key or tracker.

Try !hsweek PlayerName eu standard or !duopeak PlayerName eu. UTC weeks begin Monday. History starts with collection, so yesterday or last week may initially be empty. The stream-only !rankprogress remains separate.