A feature rich Modmail bot for Discord.

Modmail's core functionality provides an efficient communications interface between server members and staff. When a member sends a direct message to the bot, a channel is created within an isolated category for that member. This channel is where messages will be relayed and where any available staff member can respond to that user.

• Highly Customisable
  • Bot activity, prefix, category, log channel, etc.
  • Fully customisable command permission system.
  • Interface elements (color, responses, reactions, etc.)
  • Snippets and command aliases
  • Minimum account/guild age in order to create a thread.
• Thread logs
  • When you close a thread, a log link is generated and posted to your log channel.
  • Rendered in styled HTML like Discord.
  • Optional login in via Discord to protect your logs.
  • See past logs of a user with ?logs
  • Searchable by text queries using ?logs search
• Robust implementation
  • Scheduled tasks in human time, e.g. ?close in 2 hours silently.
  • Editing and deleting messages is synced on both ends.
  • Support for the full range of message content (mutliple images, files).
  • Paginated commands interfaces via reactions.

This list is ever growing thanks to active development and our exceptional contributors. See a full list of documented commands by using the help command.

Currently, the easiest way to set up the bot is by using Heroku, a container-based cloud platform. Installation via Heroku is done in your web browser and keeps the bot online 24/7 for free. The installation guide will guide you through the entire installation process. If you run into any problems, join the development server for help and support.

Installation locally for development reasons or otherwise is as follows, you will need python 3.7.

Clone the repo

$ git clone https://github.com/kyb3r/modmail
$ cd modmail

Install dependancies

$ pip install -r requirements.txt

Rename the config.json.example to config.json and fill out the fields. And finally, run the bot.

$ python3 bot.py

This project is licenced under MIT. If you have any new ideas, create an issue or a pull request. Contributions to Modmail are always welcome, whether it be improvements to the documentation or new functionality, please feel free make the change.

This bot is open source and always will be. If you like this project and would like to show your appreciation, heres the link for our Patreon.