Discord Bots

Archival Notice

Hello anyone stumbling across this repo. As it currently stands, this is one of my most starred repositories, and I started it years ago to make it easier to write Discord bots in Python using the discord.py API, which works great and I had a fun time doing it. However, it is time for me to archive this repository, as there is no support or new additions ever coming.

My last "real" commit on this project was over 6 years ago, and I mostly stopped using this many moons ago and no longer plan on contributing code to this. I am still bumping merge requests from the automated systems to bump dependencies, but even that feels unnecessary. I would rather archive this and let it be preserved; anyone interested in supporting this can fork this and make new additions / do whatever they please. It is MIT licensed, you can do as you wish.

This notice will be the last commit, and I will publish this as a 1.1 tag to make it final. Thank you for all the fish and stars, and I hope my code was helpful to anyone who happened to find it.

---

A collection of Robots for Discord.

Docs

• AsyncIO Docs
• Discord.py API
• Discord Dev Portal

Introduction

Discord, the popular chat service aimed at gamers, supports a WebSocket API for sending and receiving data. From this we can create Bot users, so this project has the sole focus of creating various bots to be used with the Discord service.

In it's current state, this project has Python code wrapping around the discord.py library itself to aid in the development of bots, as well as bots written in Python with many different goals of doing as much as they can.

Currently, there's two types of Bots that can be used with Discord:

• Interactive chat bot - a bot that receives and can send messages to channels
• WebHook bot - a bot that can only send data to a channel via a URI endpoint

Requirements

To run this project you will need:

• Python 3.6
• Racket 6.5 (for the superv manager)
• Pip for Python
• virtualenv installed from Pip
• Your own set of Discord credentials to use with Bots

Setup

The code can be cloned entirely from the Git repository and set up with Pip.

git clone https://gitlab.com/sleibrock/discord-bots.git && cd discord-bots
virtualenv dev
source dev/bin/activate # source dev/Scripts/activate for Windows
make setup
make run

Each bot needs a key in order to use the Discord API. A Chat Bot requires an access token that is assigned when you create a Bot account under your Discord Developer page. A WebHook Bot requires a WebHook URL to post data to. Keys are stored in JSON format for easy loading, so use the following format and store the keys under a keys/ folder named <bot-filename>.key.

{
    "key": "secret_key" # or https:// link for webhook bots
}

Bots Maintained Currently

Here's the list of bots under development.

• dumb-bot, a basic bot to integrate with the rest of the project
• dota-bot, an automated daemon to send Dota match info through WebHooks
• eco-bot, a game-economy assistant to look up prices (early development stages)

Other bots are currently being ported from an older library, have been removed, or are just undergoing plain old experimentation for the time being. Disabled bots lie in the junkyard folder.