Go to file

Miikka Virtanen 15d74d162a Add MIT license		2017-03-01 09:58:53 +02:00
attachments	Add attachment rehosting; forward attachments in replies	2016-12-16 09:26:05 +02:00
db	Start huge refactor	2017-02-10 04:56:36 +02:00
logs	Add log saving and serving	2016-12-06 02:29:55 +02:00
src	Handle it gracefully when we can't get guild member info. Indicate if this was due to the member not existing on the guild or because the endpoint didn't give us enough data.	2017-02-15 01:26:17 +02:00
.editorconfig	Initial commit	2016-12-06 00:25:20 +02:00
.eslintrc	Start huge refactor	2017-02-10 04:56:36 +02:00
.gitignore	Add new user greetings	2017-02-10 07:04:23 +02:00
.nvmrc	Major refactor about done	2017-02-10 06:36:47 +02:00
LICENSE.md	Add MIT license	2017-03-01 09:58:53 +02:00
README.md	Update README.md	2017-02-10 07:47:10 +02:00
config.example.json	Add more info at the start of modmail threads. Change greetingGuildId to a more universal mainGuildId. Start using semi-proper version numbers.	2017-02-15 00:57:53 +02:00
package.json	Clear license from package.json	2017-02-19 00:48:10 +02:00
update.sh	Major refactor about done	2017-02-10 06:36:47 +02:00
yarn.lock	Add more info at the start of modmail threads. Change greetingGuildId to a more universal mainGuildId. Start using semi-proper version numbers.	2017-02-15 00:57:53 +02:00

README.md

Modmail for Discord

A bot for Discord that allows users to DM the bot to contact the server's entire mod team. These DMs get relayed to a modmail server where each user gets their own channel, or "thread". Moderators and admins can then reply to these threads, and these responses are relayed back to the original user as a DM.

Inspired by Reddit's modmail system.

Setup

Install Node.js 6 or higher
Clone or download this repository
Create a Discord server to be used as the modmail inbox
Copy config.example.json to config.json and fill in the values
Install dependencies: npm install
Run the bot: node src/index.js

Commands

Anywhere on the modmail inbox server

!logs <user> Lists previous modmail logs with the specified user
!block <user> Blocks the specified user from using modmail
!unblock <user> Unblocks the specified user from using modmail

Inside a modmail thread

!reply <text> Sends a reply to the user in the format "(Role) User: text" (alias !r)
!anonreply <text> Sends an anonymous reply to the user in the format "Role: text"
!close Closes the modmail thread and saves a log of it
!logs Lists previous modmail logs with this user
!block Blocks the user from using modmail
!unblock Unblocks the user from using modmail