chamburr / Modmail
Programming Languages
Labels
Projects that are alternatives of or similar to Modmail
ModMail
A feature-rich Discord bot for easy communication between server staff and users.
A new channel is created whenever a user messages the bot, and the channel will serve as a shared inbox for seamless communication between staff and the user.
To learn more, check out our website or visit our Discord server.
Contributing
There are many ways you can contribute to this project:
For more information, please see our contributing guidelines.
The issue tracker here is only for bug reports and suggestions. Please do not use it to ask a question. Instead, ask it on our Discord server.
Self-Hosting
This self-hosting guide requires you to have some basic knowledge about command line, Python, and Discord bots. We do not provide any support for self-hosting.
Prerequisites
In order to run ModMail, you will need to install the following software. Please also note that ModMail can only be hosted on UNIX based operating systems. Windows is not supported.
Getting the Sources
Clone this repository, or fork and clone if you wish to make pull requests.
git clone https://github.com/chamburr/modmail.git
Configuration
Configuration is done through a config.py
file. A template can be found in config.example.py
.
You can create a copy of it and rename it to config.py
, then fill in the configurations.
Installing Modules
ModMail utilises several modules to function properly. The list of modules can be found
in requirements.txt
. You can install them with the following command.
pip3 install -r requirements.txt
Running the Bot
Congratulations! You have set up everything, and you can finally have the bot up and running. Please start twilight-dispatch first, then use the following command to start the bot.
python3 launcher.py
License
This project is licensed under GNU Affero General Public License v3.0 .