Skip to content

First Time Setup Guide

Makar edited this page Mar 23, 2023 · 23 revisions

Prerequisites

This plugin requires Microsoft .NET Framework 4.8 or later.

Supported operating systems are Windows 8+.

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_DiscordTriggers.dll from the Releases page.

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

  3. Place the ACT_DiscordTriggers.dll file in the %APPDATA%\Roaming\Advanced Combat Tracker\Plugins\ folder.

  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. Restart ACT.

  9. 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, 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.

Help!

Please see the Common Questions and Issues page.