Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Special notice: QQbot will be unavailable due to SmartQQ stop service on Jan. 1st 2019 and this plugin will be unavailable too. Thanks for your support and help!


A qq bot to provide info(etc. player stat and deto) of online PC game World of Warships(WoWS) via qqbot.


wows info bot via qqbot(wows info bot as follows) is a plugin of qqbot which provide players' statistics info of online PC game World of Warships(WoWS). This bot monitor qq group members' discussion and do the response to specific instructions.

Notice: The statistics info fetches from Wargaming Official API and you must agree with Wargaming API Terms Of Use. If you do not agree with the term above, you SHOULD NOT use this bot plugin.

Official QQ group for testing and feedback 891803204.


This plugin is based on Python 3.6. Although qqbot just need Python 2.7/3.4+, some syntax and function features may not supported by former versions so Python 3.6 is strongly recommended, or you may need some time to fix problems before enjoy it.

To start wows info bot, you need to install qqbot first. You can use pip to install qqbot.

pip install qqbot

Then download files of this plugin and put them into plugin folder of qqbot at ~/.qqbot-tmp/plugins/( ~ represents user folder, for example in win7 it should be C:\Users\xxx ).

Open file with notepad, fill in all the parameters surrounded by <>. In the latest version, you just need to fill in your wargaming application id(Notice: NOT YOUR WARGAMING ACCOUNT ID) which can apply from Wargaming Developer's Room. After that, rename file to before start this plugin.

Start qqbot and open another console. Use qq plug wowsinfo to start wows info bot.

More info related to qqbot plugin can be found in the qqbot readme.

Instructions Usage

You can send instruction to bot either directly or in a group which bot also joined except some special instruction. Of course you can change this and other details, even add new instructions on your own!

-start & -stop

Use -start wowsinfo to start bot if bot closed before.(by default the bot has been started when start wows info bot plugin)

Use -stop wowsinfo to stop bot. Notice: This is used to start or stop this plugin, not qqbot. These two instructions only works when send by bot's buddy, not in the group.


Use -time to get system time.


Usage -echo <content>

Send content back, just like echo instruction in Linux.


Usage -deto <user_name>

Show player detonation info(deto count & deto ratio last week & overall with rank number(marked with #)) fetched from WOWS Detonation Ranking. Only deto info of players from ASIA server available.

You do not need to type in accurate user_name because it's case insensitive and has automatic completion. For example, input "himeuz" can find player "HimeUzuki" since no other player user_name start with "himeuz" and it's case insensitive.


Usage -info [-cv|bb|ca|dd|all] [-r=eu|ru|na|asia] <user_name>

Show player pvp statistics info(battles, win rate, main battery hit ratio, PR, average damage dealt, max damage dealt) and other detail info when given specific paramneters.

-cv|bb|ca|dd|all, show 3 most played ship(with type cv|bb|ca|dd or all ships) statistics info in pvp mode.

-r=eu|ru|na|asia, select player server which is asia on default.

For example, -info -dd -r=asia himeuz means that show general pvp statistics info and 3 most played distroyer statistics info of asia server player whose user_name like "himeuz" most.

Meme Usage

You can change to add your user_name map and meme map.


Since some players' user name too long or has other nickname known by others and this will not cause ambigious, you can use this nickname to query statistics of this player.

For example, in user_meme_map, 'didi': 'Cyclopenta_pentalene ' means that you can use -info didi instead of -info Cyclopenta_pentalene.


You can show some other words after display of statistics info to make fun.

For example, in meme_map,

'Cyclopenta_pentalene': [

means that after display player Cyclopenta_pentalene's info, one of these meme sentences will be shown.

Notice: These sentences should start with \n for starting a new line.

Bonus Code

Try -info momotxdi several times and pay attention to avgdmg field!

Special Thanks


A qq bot to provide info(etc. player stat and deto) of online PC game World of Warships(WoWS) via qqbot.





No releases published


No packages published