Discord Bot
SC2 Pulse provides a discord bot for StarCraft2. Invite the bot to your discord server. Used in 276 servers.
Slash commands
Type / in the chat box to see available slash commands.
/1v1-summary
Shows MMR(last, average, and max), games played, race, region, and league.
- name
- 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.
/roles
Triggers auto role assignment
Required permissions(for the bot): MANAGE_ROLES
User commands
Click on a user->apps to see available user commands.
1v1-summary
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.
Triggers
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
| Region | Supported roles |
|---|---|
| NA | NA, US, North America, America, Americas, United States |
| EU | EU, Europe |
| KR | KR, TW, South Korea, Korea, Taiwan, Asia |
| CN | CN, China |
League
| League | Supported roles |
|---|---|
| bronze | bronze, metal |
| silver | silver, metal |
| gold | gold, metal |
| platinum | platinum, plat, metal |
| diamond | diamond |
| master | master, masters |
| grandmaster | grandmaster, grand master, GM, grandmasters |
Race
| Race | Supported roles |
|---|---|
| Terran | Terran |
| Protoss | Protoss |
| Zerg | Zerg |
| Random | Random |
Range
Some parameters support integer ranges as role names. Format:
from(included)-to(excluded) suffix. Role example: 4000-5500 mmr.
| Parameter | Suffix |
|---|---|
| Current rating | mmr |
FAQ
- 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)
