CodingPenguin/clashofclans-bot
A Discord chat bot that optimizes the player experience for Clash of Clans, one of the most popular, free, mobile games of all time.
This bot is used to fetch in-game player data by using the official Clash of Clans API. ClashStats Bot is still under testing and some features have yet to be implemented. Suggestions are encouraged!
Commands
Currently, nine commands are able to be used.
/verify
When ran, the bot will DM the user and prompt their in-game player tag and API token (also found in-game). This command allows the user's data to be saved to the database, and therefore, the user will be able to run other commands. The experience with this bot is much better when the user has verified.
/stats
When ran without verification, the bot requires a player tag argument to be entered after the command.
/stats #GY2GJLCP
When ran, and the user has already been verified, no additional arguments are required.
/clan
This command requires user verification before use. If the user does not have a default clan saved, the user will need to input a clan tag:
/clan #2PGJUGPR
At this point, the bot will prompt if the user would like to save the inputted clan tag as their default clan. If so, the next instance of /clan will not need a clan tag; instead, it will fetch the clan data from the saved clan tag:
/clan
And if you're curious what metrics are shown, here are some images!
/graph
This command requires user verification before use. The user's saved trophy data will be plotted (via matplotlib) on a line graph. New data can only be saved once daily, but the graph can be seen as many times as prompted.
/hero
This command requires verification before use. Lists your hero levels. Tells how far you are from maxed hero levels at your Town Hall level.
/zap
Tells the player how many lightning spells are required to destroy an air defense.
This command requires two parameters: the air defense level and your lightning spell level.
/zap [air defense level] [lightning spell level]
/zapquake
Tells the player how many lightning spells and earthquake spells are required to destroy an air defense.
This command requires three parameters: the air defense level and a lightning spell level, and an earthquake spell level
/zapquake [air defense level] [lightning spell level] [earthquake spell level]
/destroy
Destroy your data from ClashStats. We will no longer hold your data in our database. This decision is permanent and cannot be undone!
/invite
Fetches the permanent Discord invite link for ClashStats.
/help
Sends the command list!
Contribute & Support
Want to add the bot to your server? Use this link!
Need more support? Join the support server and ask me directly!
Want to support? Buy me a coffee!




