Add some documentation
parent
513439746f
commit
ecfecf3f9e
|
@ -0,0 +1,28 @@
|
||||||
|
# Modmail for Discord
|
||||||
|
A bot for [Discord](https://discordapp.com/) 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
|
||||||
|
1. Install Node.js 6 or higher
|
||||||
|
2. Clone or download this repository
|
||||||
|
3. Create a Discord server to be used as the modmail inbox
|
||||||
|
4. Copy `config.example.json` to `config.json` and fill in the values
|
||||||
|
5. Run the bot with `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
|
|
@ -0,0 +1,4 @@
|
||||||
|
{
|
||||||
|
"token": "your bot token",
|
||||||
|
"mailGuildId": "id of the modmail inbox guild"
|
||||||
|
}
|
|
@ -7,9 +7,9 @@
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
"author": "",
|
"author": "",
|
||||||
"license": "ISC",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"eris": "github:abalabahaha/eris#dev",
|
"eris": "^0.5.2",
|
||||||
"mime": "^1.3.4",
|
"mime": "^1.3.4",
|
||||||
"moment": "^2.17.1",
|
"moment": "^2.17.1",
|
||||||
"public-ip": "^2.0.1"
|
"public-ip": "^2.0.1"
|
||||||
|
|
Loading…
Reference in New Issue