Note: I've sporadically updated this repository inorder to make the bot compatible with the changes Blizzard makes with their APIs.

Since the project isn't much of a priority for me - a lot of functionality has been slowly lost over time with efforts to make the bot compatible with Blizzard API updates. Especially since Blizzard continues to remove/break more and more endpoints.

As of this year (2020) Blizzard 'temporarily' disabled their Starcraft II API until further notice.
https://us.forums.blizzard.com/en/blizzard/t/starcraft-ii-community-api-update/2652
As someone who's developed alongside their API for several years - I do not think this update will be done anytime soon. Maybe towards the end of the year - as we (the dev community) were promised an update in February and it's now March.

TaeJa Bot

TaeJa Bot is a Discord Bot for Starcraft II clans. It runs on the Mojo::Discord library.

TaeJa Bot can help manage your clan or simply for viewing player statistics.

Sample Outputs

Player Search

Clan Search

MMR Bounds

Command List & Options

help

• ~help
• ~help <other command name>

player

• ~player <username>
• ~player <username>[#sctag]
• ~player <username> [bronze|silver|gold|platinum|diamond|master|grandmaster]
• ~player <username> [terran|zerg|protoss|random]
• ~player <username> [us|kr|eu]
• ~player <username> [1..#]

bnet

• ~bnet <username>
• ~bnet <username>[#btag]
• ~bnet <username> [bronze|silver|gold|platinum|diamond|master|grandmaster]
• ~bnet <username> [terran|zerg|protoss|random]
• ~bnet <username> [us|kr|eu]
• ~bnet <username> [1..#]

clan

• ~clan <name>
• ~clan <name> [count <league|race>]
• ~clan <name> [terran|zerg|protoss|random]
• ~clan <name> [bronze|silver|gold|platinum|diamond|master|grandmaster]
• ~clan <name> [us|kr|eu]
• ~clan <name>

bounds

• ~bounds <na|kr|eu>

Command Explanations

~help

• Displays all available bot commands, if the command is followed by another command name, it'll give a detailed help page for the said command. i.e ~help player will display a detailed help page for that command & its available options.

~player

• Given a <username> it'll display a list of all users with a similar name. Aditional parameters can be given to narrow down your search.
• i.e. if you don't know their exact name, but know they are a "diamond" "zerg" in the "us" server, you can use the command: ~player part_of_name diamond zerg us.

~bnet The same explanation applies for ~bnet. Except that ~bnet searches for people by their Blizzard/Battle.net name rather than their in-game Starcraft name.

How It Works

Rather than querying Blizzard's API everytime the bot is used, an hourly job executes a script to update a local database which is where the bot collects its data from.

With this system, the bot can provide more generalized and insightful view on data that would otherwise be near-impossible to classify from a straightup query of Blizzards API.

Categorization and querying of Clan Tags, Player Names, Player Battle Tags are not possible with Blizzard's API alone.