Skip to content

First Time Setup Guide

Mark edited this page Apr 11, 2018 · 23 revisions

Prerequisites

This plugin requires Microsoft .NET Framework 4.6.2 or later.

Step 1: Setup Discord Bot

  1. Go to the Bot creation page.

  2. Enter the name of your bot in the "APP NAME" section

  3. (Optional) If you'd like, add an App Description and an App Icon (Avatar)

  4. Press the "Create App" button

Step 4

  1. Click "Create a Bot User"

Step 5

Step 2: Invite the Bot to your Server

  1. In the "APP DETAILS" section, look for "CLIENT ID"

Step 1

  1. Replace CLIENT_ID_HERE with your Client ID in the following link: https://discordapp.com/oauth2/authorize?client_id=CLIENT_ID_HERE&scope=bot&permissions=8. For example, if your Client ID was 304822618350157836, then your link should be https://discordapp.com/oauth2/authorize?client_id=304822618350157836&scope=bot&permissions=8

  2. Open the link you created in previous step in your browser. Select a server to join from the list. You must have server-management privileges on the server, or else it will not show up on the list. If you do not have server-management privileges, give the link to an admin of the server and ask them to add it. If you get "Unknown Error", please make sure you created a bot user (see step 5 in "Setup Discord Bot"). Press "Authorize" to continue

Step 3

  1. Unless the option was unchecked, your Bot should have Administrator privileges. Please note that your Bot must be able to access all voice channels that you want it to be able to join. If your server admin does not want your Bot to have Administrator privileges, then please ask them to give the bot access to the desired voice channels.

Step 3: Plugin Setup

  1. Download ACT-Discord-Triggers.zip from the Releases page.

  2. Right click the zip file, open "Properties" and unblock the zip if necessary.

  3. Extract and place the DiscordTriggers folder where Advanced Combat Tracker is installed.

  4. Run Advanced Combat Tracker as Administrator.

  5. Click the Plugins tab and press "Browse"

  6. Open ACT_DiscordTriggers.dll

  7. Press "Add/Enable Plugin" in ACT.

  8. Click on the newly created "Discord Triggers" tab.

Step 4: Grabbing your Bot Token

  1. Go to the Bot management page and select your Bot.

  2. Under "App Bot User" there should be a field for "Token". Click "click to reveal" and copy this Token.

Step 2

  1. Put the Token that you copied in the "Discord Bot Token" section of the Plugin. Do not share this token with others.

Step 3

  1. Restart ACT and you are finished!

Using the Bot

If all is setup correctly (and I didn't break something), the discord bot will go online every time you start ACT. Select a server and channel from the drop-down boxes and press "Join Channel" to make the bot join that channel. The token and ID you entered will save when you close ACT so you do not have to enter that again.

Known Issues

Please see the issues page for a list of known bugs.

Clone this wiki locally