Gmbot - Chatbot for gamers


I used to play Clash of Clans (COC) which had a system of clan wars. Then on April 2016 I quitted from the COC and started playing Doodle Army 2: Mini Militia (DA2) and I played it a lot, so much so that I made friends from Kerala, Rajasthan, Delhi and even outside India. We friends created a group over WhatsApp and named our group Headshot Killers (HSK) and every player in that group had to put HSK after their in-game name (IGN). Similarly, other people created their own groups. Our group used to practice together and challenge other groups.

In a way, I found that if we had a clan war system like the one in the Clash of Clans for Doodle Army 2: Mini Militia it would have been so nice. We requested appsomniacs developers over their Beta testers google group, they did add a friend system in one of their updates, but it was far from what we requested. Thus, this Gmbot is my gift to the community, a feature what we gamers wanted.


Create your clan, challenge others and grow

  • After adding chatbot to a discord server, the server acts as a “Clan”. All the users in that server acts as clan members or co-leaders or leader. A clan can create or participate in “Clan Wars”. Team up with allies and fight other clans! Each win grants you a certain amount of Glory points.
  • These clan wars are played in many types of formats depending upon games:
    • 1x1 match
    • 2x2 match
    • 3x3 match
    • 4x4 match

Key Features

  • No need for maintaining spreadsheets for match records
  • Simple easy commands with help guide
  • Finding similar gaming community
  • Leader board of Glory points
  • Roles to manage clan
  • Statistics of clan

How it works

  1. A clan leader or co-leader creates a war request taking some players who are available and game
  2. Other clans who have subscribed to that game will receive challenge request
  3. One of the clans accept the challenge
  4. Now both clans can communicate and share game details
  5. After the war duration gets completed clan war is over
  6. Bot will ask for the winner from both the clans
  7. And the winning clan gets glory points



  • Can promote and demote players.
  • Can update clan details.
  • Can create/delete/accept clan wars.
  • Can subscribe/unsubscribe games
  • Can participate in clan wars


  • Can create/delete/accept clan wars.
  • Can subscribe/unsubscribe games.
  • Can participate in clan wars

Regular Member

  • Can participate in clan wars


  • Can’t do anything


Online Gaming Communities

Unlike classical forms of online communities or the newer phenomenon of social network sites, community structures of online gamer communities tend to be diverse, highly complex socio-technological structures centred around the organization, (meta-) communication, exchange (e.g., of virtual items) of game-related issues and events. Memories of staying up late playing Warcraft 3 with friends or sharing creations in The Sims.

Identifying right Platform

Discord’s free voice and text chat is about making it easier for these online gamers create their communities on this platform. Many gamers from all over the world have started their groups with the people they play together, create these memories, and land a headshot or two.

The core idea was to help connect multiple clans playing same game to play against each other. Heavy part of the idea relies on creating a clan like experience where clan members can collaborate, practice and share memories via text and voice chat. Developing my own system providing such experience with limited knowledge, resources and time is quite a challenge. Also, making gamers who have their groups on discord switch to my own such platform would have placed me against Discord. So, it was ideal to leverage 87 million potential registered uses of discord which tends to overlap with our target users via chatbot for discord.


Step 1 - Installation

Most people having their discord group will start by adding the chatbot to their server (group) by clicking “Add to Server” button on visiting the static landing website of Gmbot. This website will also act as a command directory.

After clicking add to server, user will be taken to discord’s official website where that user will need to give necessary permissions to bot and Authorize. After that server will start acting as a Clan and chatbot will start responding to querries.

Step 2 – Subscribe game(s)

Step 3 – Create war request

Step 4 – Accept Incoming war

Step 5 – Communicate

Step 6 – Ask for results


Flow diagram

Tree diagram

│ Gmbot
├─── COGS (Separate python file for each command all inside this folder)
│ ├───
│ └───
├─── DAO (SQL Queries related to each command)
│ ├───
│ └───
├─── guide (images/ resources)
│ └─── ERDiagram.png
├─── (Singleton class, Database related functions will be present here)
├─── database.sql (SQL script to create all database tables)
├─── discord.log (Log dump)
├─── (Command parser and checker)
└─── (Root main file which executes first and loads all the commands)


Code Structure

All the SOLID design principles have been taken in mind for structuring the code.

The code has been structed so beautifully that extending the project is super simple, all command follows similar structure.

  • Create class command_name_Command implementing discord.commands.Cog
  • Create 3 methods:
  1. Name same as command_name with @commands.command() as a decorator.

This method calls methods from Query

Based upon query response, it calls success response or error response

  1. Success message response
  2. Error message response
  • Setup method to add that command class



List of Commands

List of Commands Function Access level
setup Please enter/edit your clan name [REQUIRED]Please enter/edit clan location [OPTIONAL, DEFAULT=International]Please enter/edit clan language [OPTIONAL, DEFAULT=English] Leader only
createWar Please tag all the players you want to take part [REQUIRED]Please enter game id [REQUIRED]Please enter duration in hours after which the war will end [OPTIONAL, DEFAULT=24 hours]Please enter type id of clanwar [OPTIONAL, DEFAULT=First to 3 wins] Leader and Co-Leaders only
privateWar (does not broadcast war request) Please tag all the players you want to take part [REQUIRED]Please enter game id [REQUIRED]Please enter duration in hours after which the war will end [OPTIONAL, DEFAULT=24 hours]Please enter type id of clanwar [OPTIONAL, DEFAULT=First to 3 wins] Leader and Co-Leaders only
removeWar Please enter war id [REQUIRED] Leader and Co-Leaders only
accept Please enter war id [REQUIRED]Please tag all the players you want to take part [REQUIRED] Leader and Co-Leaders only
communicate Please enter message you want to convey [REQUIRED]Shares messages between 2 parties Only works for participating players when 2 clans will match-up
subscribe Please enter comma separated valid game ids you want to subscribe [REQUIRED]Lists all games subscribed by a clan Leader and Co-Leaders only
unsubscribe Please enter comma separated valid game ids you want to unsubscribe [REQUIRED]Lists all games subscribed by a clan Leader and Co-Leaders only
relinquish Please tag the player you want to transfer ownership (Leader role) [REQUIRED] Leader only
promote Please tag all the player you want to make Co-leader responsibility [REQUIRED] Leader only
demote Please tag all the player you want to take away Co-leader responsibility [REQUIRED] Leader only
status Lists all ongoing warLists all open war requestsChecks alls game subscribed Anyone
games Lists all supported games with ID Anyone
formats Lists all available clanwar types Anyone
mygames Lists all games subscribed by a clan Anyone
roles Lists all the players along with their role Anyone
available Mark yourself available to take part in clan war Anyone
unavailable Mark yourself unavailable to take part in clan war Anyone



Google Analytics

Play Testing

The setup command was used to provide clan name, language, location and required game ids to subscribe for a game. But most alpha testers ignored to subscribe to games as the command wasn’t as descriptive and started creating clan war requests. Which lead to a separate command to subscribe and unsubscribe. Also, Testers did not like long commands name especially communication command which was shortened to “gmbot say”.

Play Test and Feedback

comments powered by Disqus