Mod Mail for Discord

This is an open source discord bot made by kyb3r and improved upon suggestions by the users!

Hosting on Heroku

What is Heroku?

Heroku is a free hosting site that can host many web apps. However, the web apps cannot store any data.
We have made Mod Mail to do exactly that. It was made to be stateless and not store any data in json files or any other storage files.

How do I do it?

If you choose to install the bot using Heroku, you do not need to download anything. In fact, you can set it all up on a phone!

Heroku Account

You need to make a Heroku account. Make one at Heroku's Website and then follow the steps below:

Setting it up

Create a Bot Application for Discord
Head over to the applicatons page.
Click “new application”. Give it a name, picture and description.
Click “Create Bot User” and click “Yes, Do It!” when the dialog pops up.
Copy down the bot token. This is what is used to login to your bot and will be used at Step 8, or 11 if you are setting up on your PC.

Here's a GIF to explain the first 5 steps

Click this button:
Input some random name for your app, the heroku app name is not important.
Input your bot token from step 5 into the TOKEN field.
Put the ID of your Server into the GUILD_ID field.
Put the command prefix you want in the PREFIX field. e.g ? The default prefix is m.
Click the deploy app button and wait for it to finish.
Click manage app and go into the resources tab.
Now turn on the worker by clicking the pencil icon.
If you want, you can go over and check the application logs to see if everything is running smoothly.
Once the bot is online in your server, do [your prefix]setup and you are good to go!
You can add the bot to your server with this tool. Your Client ID is retrived from the applicatons page

Now you should be done. Go over to discord and try it out!

Make sure to give the bot manage channel permissions!

Self-Hosting on your own PC or VPS

Installing Python

This is a bot written in the python programming language. So if you don't already have python correctly installed, you must install it.

Installing the Bot

Now that you have python installed, you are good to go. Follow the steps below for a successful installation.

Look at Steps 1 to 5 of Setting up on Heroku
Download the bot from the github page.
Extract the zip file to the desktop or wherever you want.
Open your terminal or cmd.
Navigate to the bot folder. i.e cd desktop/modmail-master
Install all the requirements: pip install -r requirements.txt
Run the bot with python bot.py or on mac or linux python3.6 bot.py
Enter your token and server ID in the wizard.
Once the bot is online in your server, do [your prefix]setup and you are good to go!
You can add the bot to your server with this tool. Your Client ID is retrived from the applicatons page

Updating your ModMail (Heroku)

Go to https://github.com/<YOUR GITHUB USERNAME>/modmail/compare/master...kyb3r:master?quick_pull=1&title=Updating
Click Create pull request

It should look exactly like the image
Scroll all the way down till you see the following image
Click Merge pull request
Go back to Heroku and click Deploy
Click Deploy Branch

Create an issue if you need help

IF STEP ONE GIVES A 404 ERROR

You would have to redo from step 6 of this

Thanks For Using This Bot!

If you do use the bot, a star on this repository is appreciated ;)

Dont copy this code or incorporate the code into your own bot without permission and/or credit.

kidotuti/modmail