Discord Backend¶
Discord backend for [Errbot](http://errbot.io). It allows you to use Errbot from Discord to execute commands.
Installation¶
An Errbot instance is required to install the discord back-end. See the Errbot installation documentation for details.
Requirements¶
- Python 3.6 or later
- Discord.py 1.7.3 or later
Virtual Environment¶
The steps below are to install the discord back-end in Errbot’s virtual environment. In the examples below, the virtual environment was set to /opt/errbot/virtualenv and Errbot initialised in /opt/errbot. The “extra” back-end directory is set to /opt/errbot/backend.
1. If not already set, set Errbot’s BOT_EXTRA_BACKEND_DIR variable in /opt/errbot/config.py to the directory you will use to place additional back-ends. .. code: none
BOT_EXTRA_BACKEND_DIR=/opt/errbot/backend
2. Set the back-end to use Discord. .. code: none
BACKEND = “Discord”
3. Clone repository to your Errbot back-end directory. .. code: none
cd /opt/errbot/backend git clone https://github.com/gbin/err-backend-discord.git
4. Install back-end dependencies (Errbot’s virtual environment must be activated to install the dependencies into it). .. code: none
source /opt/errbot/virtualenv/bin/activate cd err-backend-discord pip install -r requirements.txt deactivate
5. Set the bot’s token (see _Create a discord application_ for information on how to get the token). .. code: none
- BOT_IDENTITY = {
- “token” : “changeme”
}
- Enable SERVER MEMBERS INTENT for your bot on the Discord website. See `here <https://discordpy.readthedocs.io/en/latest/intents.html?highlight=intents#privileged-intents>_ for the required steps.
Create a discord application¶
For further information about getting a bot user into a server please see: https://discordapp.com/developers/docs/topics/oauth2. You can use [this tool](https://discordapi.com/permissions.html) to generate a proper invitation link. The reactiflux community have written a quick start guide to creating a discord bot and getting a token
Acknowledgements¶
This backend gratefully uses the invaluable discord.py python module.
Contributing¶
- Fork it!
- Create your feature branch: git checkout -b my-new-feature
- Commit your changes: git commit -am ‘Add some feature’
- Push to the branch: git push origin my-new-feature
- Submit a pull request :D