Pulse SC2 Pulse

Discord Bot

SC2 Pulse provides a discord bot for StarCraft2. Invite the bot to your discord server. Used in 258 servers.

Slash commands

Type / in the chat box to see available slash commands.


Shows MMR(last, average, and max), games played, race, region, and league.

The search uses the same rules as the regular player search on the website which means you can search by name, BattleTag#1234, [clanTag], or starcraft2.blizzard.com profile link.


Triggers auto role assignment

Required permissions(for the bot): MANAGE_ROLES

User commands

Click on a user->apps to see available user commands.


The bot will try to find user's stats by searching in the following order:

  • BattleTag(if the user has linked their Discord account to their SC2 Pulse account)
  • Server username(trimmed)
  • Discord username(trimmed)

Role management

The bot supports several types of role management. The Assigned roles are based on the user's main team. The main team is picked from LOTV_1V1 queue types, last 3 seasons. Sorting order: season(desc)->queue type(asc)->mmr(desc)->id(asc). The first team that matches is used as the main team.

Linked roles

The bot provides an Application Connection that can be used in Linked Roles. Bear in mind that Linked Roles can't be auto assigned, users have to manually opt-in for a role.

Auto roles

An alternative method that supports auto assignment. Only the pre-defined role names are supported. Users have to link their discord account.

Required permissions(for the bot): MANAGE_ROLES. Make sure the bot role is above managed roles in the list of roles(server settings).

Execute the /roles command to make sure the server is configured correctly.


The roles will be updated for a user when:

  • A new ladder data is detected(i.e. the user has finished a ranked match)
  • The user links their Discord account
  • The user unlinks their Discord account. The roles will be dropped in this case.
  • The user executes the /roles slash command
Supported roles

Role names are case insensitive

Region Supported roles
NA NA, America, North America, US, United States, Americas
EU EU, Europe
KR KR, Taiwan, Korea, South Korea, TW, Asia
CN CN, China
League Supported roles
bronze bronze, metal
silver silver, metal
gold gold, metal
platinum platinum, metal, plat
diamond diamond
master master, masters
grandmaster grandmaster, GM, grand master, grandmasters
Race Supported roles
Terran Terran
Protoss Protoss
Zerg Zerg
Random Random

Some parameters support integer ranges as role names. Format: from(included)-to(excluded) suffix. Role example: 4000-5500 mmr.

Parameter Suffix
Current rating mmr


My users can't use the bot
Make sure your users have a permission to use application commands(server config). Also make sure that required commands are enabled in the integration config(click on the bot->manage integration)