Hearthstone command reference

Show the streamer’s full BattleTag, separately from social links. Protected native command.

The broadcaster configures it with !tag set Player#1234. A former plain-text tag command or full Default player is retained as a fallback. Incomplete names and dynamic templates are not treated as full BattleTags.

Try: !tag set Player#1234

Show the streamer’s configured local time plus US West, US East and London, with date and daylight saving adjustments.

The broadcaster sets an IANA timezone, for example !time set America/New_York. Until configured, the reply explicitly says the streamer timezone is unknown and shows UTC plus the regional conversions.

Try: !time set America/New_York

Show the latest recorded Standard or BG result and its permitted replay link.

Mac companion required for Standard. HSReplay links are channel opt-in, based on tracker-confirmed uploads; pending games never return an older replay. BG uses McBotem’s player. No automatic chat announcements.

Try: !replay

Show the latest recorded BG placement, MMR change and public replay link when captured.

Connect the Mac companion and play with HSTracker running. New replay recordings are shared with viewers by default; the channel owner can switch replay privacy off or publish older private recordings in Hearthstone settings. Viewers need no login. Results are separate from public leaderboard observations and manual !hsstats.

Try: !bglast

Show the rank label saved by the channel, or update it as a moderator.

This is a manually saved label, separate from the public leaderboard lookup.

Try: !hsrank set Diamond 5

Show the session’s manually recorded win/loss count.

Use !win and !loss to record results. Counters reset on bot restart. Mac BG imports are separate; use !bglast or the dashboard for those results.

Try: !hsstats

Add a win or loss to the session counters.

Records a manual result; it does not change leaderboard MMR.

Try: !win

Show cached Standard ranks and solo/Duos Battlegrounds MMR across regions. Add wild or arena to include those modes; Arena also appears when no Standard rank exists.

No Blizzard API key required. With no player, looks up the chatter’s Twitch name.

Try: !db PlayerName wild

List the top ten players in a region and mode. Mode defaults to Standard.

Uses the public leaderboard cache. Use us for Americas in chat.

Try: !top eu bg

Show the #1 player, including MMR for Battlegrounds or the rating for Arena.

Imported commands with this name receive a separate name so the native leaderboard command stays available.

Try: !legend us bg

Compare the configured streamer’s standing at stream start with now. Full includes an observed peak when it differs from now.

Protected native command; !rankprogress remains an alias. Set Default player in Hearthstone settings. History resets for each stream; use !hsday and !hsweek for retained calendar history. No exact match results are inferred.

Try: !climb full

Show the cached solo or Duos leaderboard rank and MMR for a player in one region.

Defaults to the channel’s configured Default player and Americas. A missing cached player does not imply an unranked player.

Try: !duorank PlayerName eu

Show the regional top ten solo or Duos Battlegrounds players.

Defaults to Americas. These are regional views, not a merged global leaderboard.

Try: !duotop eu

Show cached player counts, upstream-reported totals, collected pages and latest fetch time.

Defaults to Standard and Americas. Complete page coverage does not guarantee live accuracy.

Try: !hscoverage eu duos

Share an HSGuru link to the current deck synced by Hearthstone Deck Tracker.

Requires the Windows HDT companion and the channel’s private ingest token.

Try: !deck

Show HSReplay and HSGuru links for the deck code saved in channel settings.

Set Current deck in Hearthstone settings. This is separate from the live HDT deck used by !deck.

Try: !decklink

Search for a Hearthstone card and show its details.

The channel owner supplies Blizzard API credentials in Hearthstone settings.

Try: !hscard Fireball

Link to a player’s HSGuru profile.

Supply a player name, or omit it to use the channel’s configured Default player.

Try: !hsguru PlayerName

Link to a player’s HSReplay profile.

Supply a player name, or omit it to use the channel’s configured Default player.

Try: !hsreplay PlayerName

Show the latest Hearthstone headline and article link using the HSGuru news hook.

An optional live-only news timer can announce new articles once. No tweet feed or dedicated BG filter yet.

Try: !hsnews patch

Tell a Hearthstone joke while the stream is live.

An optional timer can post jokes while live and chat is active.

Try: !joke

Show collected today rank/rating observations in the current cached season. Lower ranks are better; higher ratings are better.

Defaults to Standard and Americas. Omit the player to use the configured Default player. UTC periods; first observed is not necessarily midnight. Daily history persists for 35 days.

Try: !hsday PlayerName eu bg

Show collected yesterday rank/rating observations in the current cached season. Lower ranks are better; higher ratings are better.

Defaults to Standard and Americas. Omit the player to use the configured Default player. UTC periods; first observed is not necessarily midnight. Daily history persists for 35 days.

Try: !hsyday PlayerName eu bg

Show collected this week rank/rating observations in the current cached season. Lower ranks are better; higher ratings are better.

Defaults to Standard and Americas. Omit the player to use the configured Default player. UTC periods; first observed is not necessarily midnight. Daily history persists for 35 days.

Try: !hsweek PlayerName eu bg

Show collected last week rank/rating observations in the current cached season. Lower ranks are better; higher ratings are better.

Defaults to Standard and Americas. Omit the player to use the configured Default player. UTC periods; first observed is not necessarily midnight. Daily history persists for 35 days.

Try: !hslweek PlayerName eu bg

Show collected season best rank/rating observations in the current cached season. Lower ranks are better; higher ratings are better.

Defaults to Standard and Americas. Omit the player to use the configured Default player. UTC periods; first observed is not necessarily midnight. Daily history persists for 35 days.

Try: !hspeak PlayerName eu bg

Solo Battlegrounds shortcuts for today, yesterday, this week, last week and observed season peak MMR.

Self calendar lookups without a region prefer channel tracker results. In other channels, use an exact Twitch login whose owner enabled tracker stats sharing in Hearthstone settings. Otherwise falls back to public observations. Explicit regions and season peaks remain public; imports have no region/season binding. UTC periods; missing gameplay cannot be reconstructed.

Try: !bgweek

Duos shortcuts for today, yesterday, this week, last week and observed season peak MMR.

Like solo BG, unregioned self calendar lookups prefer imported tracker matches. Explicit regional lookups and season peaks use public observations. UTC periods; imported and public sources are labelled separately.

Try: !duoweek