Discord Tagbot

This bot tags a list of people or roles whenever there is a new message in any of the channels it can read

Requirements

To setup and run this bot, you must first install Node.js.

Setup

Clone this repository using git clone https://github.com/ahmedwalid05/Tagbot.git
Configure your bot from here and download the generated config file
Configure the bot by either:
- Copy the downloaded config.json file to the same director as the code
- OR (You can do both but the process parameters file will always take precedence).
- Pasting the entire config JSON (what would normally be in your file) into the environment variable TAGBOT_CONFIG_JSON.
Open a command prompt or terminal in the extracted directory, and run npm install.

Options

destination: The ID of the destination text channel
tags: A list of strings of the IDs of the users or roles to be tagged
title: Displayed at the top of each message. Optional.
- "title": "New Copied Message"
includeSource: Whether to include a line at the top showing the nickname, guild, and channel of the author who sent the message.
- "includeSource": true

Finding Channel IDs

Redirect sources and destinations use Channel IDs, which look like large numbers. To find these, follow these steps:

Open the Discord client.
Go to User Settings.
Go to Appearance.
Scroll to the bottom and enable Developer Mode.
Close User Settings.
Right click on any channel (only text channels are supported, not voice) and select Copy ID.

The ID will now be on your clipboard and can be pasted into the config.

Deployment

Run Locally

Open a command prompt or terminal in the extracted directory, and run npm start. You must have both node and npm installed.

Heroku

This bot is compatible with Heroku. You can use the button above to deploy it quickly.

Use the TAGBOT_CONFIG_JSON environment variable to create your config. Simply put everything that would normally be in the config.json file into this variable. Formatting does not matter.

ahmedwalid05/Tagbot