First Time Setup

Discord Setup#

You will need to setup a Discord application and bot in the Discord Dev Portal. Then you will need to turn on dev mode in Discord to grab some IDs. Lets dive in.

1. Open the Discord developer portal and log into your account.
2. Click on the “New Application” button.

3. Enter a name and confirm the pop-up window by clicking the “Create” button.

   You should see a page like this:

   

   You can edit your application’s name, description, and avatar here. Once you’ve done that, then congratulations—you’re now the proud owner of a shiny new Discord bot! You’re not entirely done, though.

4. After creating a bot user, you’ll see a section like this:

   

5. In this panel, you can give your bot a snazzy avatar, set its username, and make it public or private. Your bot’s token will be revealed when you press the “Reset Token” button and confirm. Put this is a text document temporarily so we can put it in the app.
6. Enable developer mode in Discord if not already enabled. See here.

Thank you to Discord.JS for the pictures used in this section.

App Setup#

The setup is pretty simple and you can probably just follow the UI tips, but a complete breakdown is below.

1. MatchExec should be running, if it is not, start it.

2. When the app first launches, it will seed its database and then start the setup experience. The initial screen will look like this:

   

   Click Get Started

3. Put in your Application ID and Bot Token from above into the correct fields and click Add Bot. This will open a sign in page and then add the bot to your actual server.

   

4. In Discord, right click your server’s picture in the left menu and click Copy ID. Put this in for Guild ID.
5. If you want to ping a specific role for new match announcements, open the roles list in the discord server settings. Right click the role you want to mention and click Copy ID. Paste it into the box under Announcement Role in MatchExec’s Discord settings.
6. When you are done you should have AT LEAST Application ID, Bot Token, and Guild ID filled in. Announcement Role is optional. Click Next

7. On the next page you can setup channels in discord for the app to use. Click Add Channel to add text channels for the app to use. Status indicators at the top tell you if you have a channel setup for that type of message.

   Right click and select copy ID on any Category on your server and paste that into the Category ID under Voice channels.