GitHub Readme.md
Battle for Azeroth is the final expansion this bot supports, and
4.0.6
is the last release. This bot was not created by Blizzard.
With this bot you're able to lookup a World of Warcraft character's item level, notable achievements, and pve/pvp progression with a command within Discord.
YOUR_CLIENT_ID
portion with the one found within your Discord API settings: https://discordapp.com/oauth2/authorize?&client_id=YOUR_CLIENT_ID_HERE&scope=bot&permissions=0
If you'd like to run the application outside of Heroku you can add the required configuration options as environment variables and then run the following commands using Python and Pip.
# Install & Run
$ pip install -r requirements.txt
$ python app.py
# Tests
$ python tests.py
The installation will require you to enter a number of API keys and settings as environment variables. Below you'll find an explanation of each.
Key Value Information RequiredWOW_CLIENT_ID
Required to make calls to the Blizzard API, you can sign up for a client id here.
Yes
WOW_CLIENT_SECRET
Required to make calls to the Blizzard API, you can sign up for a client secret here.
Yes
WOW_REGION
The server region you'd like to query, for example us
, or eu
.
Yes
LOCALE
The language for your selected WoW region, for example en_US
, or en_GB
. Locale depends on region. Please refer to the Blizzard API documents for more information. At this time this bot will only return data in English.
Yes
DISCORD_BOT_TOKEN
The token for your Discord bot user, you can sign up for one here.
Yes
If a required variable is missing the terminal you executed the bot from will display an error message.
The following commands are accepted by the bot.
# Displays a players PVE progression, dungeon kills, keystone achievements, etc.
!armory pve <name> <realm>
!armory pve <armory-link>
# Displays a players PVP progression, arena ratings, honorable kills, etc.
!armory pvp <name> <realm>
!armory pvp <armory-link>
# You can also provide an optional region to each query to display players from other WoW regions outside of the bot default, for example EU, US, etc.
!armory pve <name> <realm> <region>
!armory pvp <armory-link> <region>
# Displays the currnet wow token price.
!armory token
!armory token <region>
# Command list/help
!armory help
Here's a list of frequently asked questions. Please review the contribution guide if you'd like to support the project.
Q: Why does the bot not recognize my realm?
A: Realm names with multiple words must be seperated by a dash, for example burning legion would be burning-legion.
Q: Why does it show that my alt has completed an achievement?
A: Some achievements are account wide so the API response for your alt will be the same as your main.
Q: Do you plan on supporting Mythic+ scores?
A: Only if the official Blizzard API begins supporting their own metric.
Q: Why don't you show this raid?
A: I aim to support the most recent raids in the current expansion. Because Discord has a character limit I will start trimming the oldest raid in the current expansion if necessary.
Q: What expansion does this bot currently support?
A: Battle for Azeroth.