Hearthstone / Command guide

Hearthstone command reference

Use these in a Twitch channel running McBotem’s Hearthstone features. Streamers can disable, rename or restrict commands, so availability and cooldowns may differ by channel.

Check a channel’s available commands →Streamer setup guide →

Search Hearthstone commands

Ranks

!db

Everyone

!db [player] [wild] [arena]

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

!top

Everyone

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

!legend

Everyone

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

!rankprogress

Everyone

!rankprogress [full]

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

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: !rankprogress full

!bgrank / !duorank

Everyone

!bgrank [player] [us|na|eu|ap]

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

!bgtop / !duotop

Everyone

!bgtop [us|na|eu|ap]

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

!hscoverage

Everyone

!hscoverage [region] [standard|wild|bg|duos|arena]

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

Decks & cards

!deck

Everyone

!deck

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

!decklink

Everyone

!decklink

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

!hscard

Everyone

!hscard <card name>

Search for a Hearthstone card and show its details.

The channel owner supplies Blizzard API credentials in Hearthstone settings.

Try: !hscard Fireball

!hsguru

Everyone

!hsguru [username]

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

!hsreplay

Everyone

!hsreplay [username]

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

Session

!hsrank

Everyone; moderators to set

!hsrank [set <rank>]

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

!hsstats

Everyone; moderators to reset

!hsstats [reset]

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

Use !win and !loss to record results. Counters reset on bot restart; no automatic BG match tracking.

Try: !hsstats

!win / !loss

Moderators

!win or !loss

Add a win or loss to the session counters.

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

Try: !win

News & fun

!hsnews

Everyone

!hsnews [patch|esports]

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

!joke

Everyone

!joke

Tell a Hearthstone joke while the stream is live.

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

Try: !joke

Player history

!hsday

Everyone

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