/ModMail-djs

ModMail System!

Primary LanguageJavaScript

Github

ModMail

1. Features

  • Per user ticket channels
  • Open tickets for users with a command
  • Block users from using modmail
  • Disable/enable modmail on command
  • "Quick reply" snippets

Screenshots coming soon!

2. Commands

  • Utility

    • about: What is ModMail?
    • bot: Bot info
    • discord: Check Discord server status
    • help: Displays a list of available commands, or detailed information for a specified command.
    • ping: Checks the bot's ping to the Discord server.
    • eval: Executes JavaScript code.

  • Mods

    • block: Block or unblock a user from using ModMail.
    • edit: Edits a message the bot sent
    • lock: Toggle ModMail ticketing system. When disabled, normal users will not be able to send messages to ModMail, but staff roles will be able to send messages. When enabled, normal users can use ModMail as designed.
    • open: Open a ticket for a user
    • say: Repeats what the user said.
    • snippets: View, create, and delete snippets that can be used as "quickreplies" in ModMail channels. Use a snippet in the ModMail channel by typing snippet [#]

  • Admins

    • announce: Make a formatted announcement using Embed data
    • dmall: Direct message a user.
    • makeinv: Create an invite to a specified channel
    • modules: Manage modules
    • sendfile: Send a file as the bot (SVG files are NOT supported!)

  • Settings

    • setchannel: Update channel key values
    • setprefix: Change the server prefix (mention will always work)
    • setrole: Update role key values

  • Commands

    • groups: Lists all command groups.
    • enable: Enables a command or command group.
    • disable: Disables a command or command group.
    • reload: Reloads a command or command group.
    • load: Loads a new command.
    • unload: Unloads a command.

  • ModMail Ticket Channel Only Commands

    • close
      • Close a ticket channel
    • cmds
      • Shows you all ModMail ticket commands
    • snippet
      • Open the snippet menu and choose a snippet to send
    • block
      • Block this user
    • lock
      • Disable all modmail messages

3. Requirements

  • File system access
  • NodeJS v12.18.1 minimum
  • Git

This guide will not cover installing NodeJS.

4. Documentation

4.1. Setup

  1. Clone the repository git clone https://github.com/Saamstep/modmail.git
  2. Change your working directory cd modmail/
  3. Install NPM modules npm install
  4. Copy the example config file and edit it accordingly (See the Config File section below) cp example.config.json config.json
  5. Run the bot with node . OR use pm2 to keep it alive (See PM2 section)
  6. Invite your bot using my Invite Generator. You need your client ID which is found in your Developer Portal

4.2.1. status

One status message is built with an object with two key/value pairs.

  • type
    • The type of status, must be either a string containing PLAYING, STREAMING, or WATCHING.
  • msg
    • String of text that you want to display after the status type prefix.

4.2.2. modmail

  • guild
    • String of the guild ID to enable the modmail system
  • enabled
    • Boolean to enable and disable the Modmail system, this is what the lock command uses.
  • category
    • The name of the channel category to file modmail tickets under.
  • rolesAllowed
    • Array of a string of role ids or role names that also can see ModMail tickets (Mods/Admins automatically get added)
  • color
    • A decimal color value to apply to ModMail embed messages.
  • blockedUsers
    • An array of blocked user ids.

4.2.3. messages

  • ticketDesc
    • Ticket channel descriptions. [p] gets replaced with bot prefix.
  • newTicket
    • Initial message sent to users when they make a new ticket.
  • newTicketManual
    • Initial message sent to users when a new ticket is opened for them using the open command.
  • closedTicket
    • Message to send to a user when their ticket is closed.
  • blockedUserError
    • Message to send to a user when they interact with modmail when they are blocked.
  • disabled
    • Message to send to a user when they interact with modmail when ModMail is disabled.
  • about
    • Message displayed when "about" command is run.

uptime webserver

This webserver is used by me to easily check if my bot is online. You can use it if you want, or you can disable it as shown in the Config File section. The uptime webserver requires password in the header. The header must be key and the value can be anything you want. You can set this value in the Config File under apiKeys.api.

4.3. PM2

PM2 is a node module that can be easily installed and setup to keep your bot online 24/7 and auto start it if your host machine disconnects. Read the steps below to integrate pm2.

  1. (In your bot's directory) Install pm2 with npm install pm2 -g
  2. Run pm2 start index.js --name "ModMail The name ModMail can be whatever you want. It is just easy to remember.
  3. Access the logs of your bot with pm2 logs ModMail
  4. Read more pm2 commands here.

4.4 Repl.it Hosting

Using the deploy button at the top of this repository is an option for hosting. However, make sure to store your secrets safely. It is required to at least store your Discord Bot token this way to keep it safe from attackers.