Skip to content

jmlee337/discord-tournament-bot

Repository files navigation

Nicolet's Netplay Tournament Suite (NTS)

Nicolet's Netplay Tournament Suite offers TOs a range of helpful tools for running netplay tournaments, including broadcast management, overlay automation, and a Discord bot.

Download

Broadcasts

Screenshot 2025-12-07 at 12 45 17 Screenshot 2025-12-07 at 12 45 24

Overlay

Screenshot 2025-12-07 at 12 50 01

Bracket Dashboard

Screenshot 2025-12-07 at 12 39 12 Screenshot 2025-12-07 at 12 39 19 Screenshot 2025-12-07 at 12 39 24 Screenshot 2025-12-07 at 12 39 29 Screenshot 2025-12-07 at 12 53 49

Discord Bot

Screenshot 2025-12-07 at 12 51 49
Screenshot 2024-07-01 at 10 41 24 PM

Setup

Broadcast

You must have Slippi Launcher version 2.12.0 or later to use the NTS Broadcasts tab.

Enable Spectate Remote Control in Slippi Launcher Settings:
Screenshot 2025-12-07 at 13 40 21

Then start the Remote Control Server from the Slippi Launcher Spectate tab:
Screenshot 2025-12-07 at 13 40 31

Then you should be able to connect and manage your broadcasts from the NTS Broadcasts tab.

Overlay

Requires Melee Stream Tool. I recommend patching in my updated Game Scoreboard.js.

Enable Melee Stream Tool integration and set your Melee Stream Tool Resources folder in the settings dialog on the NTS Overlay tab:

Screenshot 2025-12-07 162249

Discord

Mac users, please see how to open an app from an unidentified developer.

This will only work for start.gg tournaments that Require Discord connection to register. This is required for the bot to know which Discord users are which start.gg players:
Screenshot 2024-06-30 222512

To make a Discord bot, click the New Application button at https://discord.com/developers/applications:
Screenshot 2024-06-30 214045

Copy the APPLICATION ID from the General Information tab:
Screenshot 2024-06-30 213939

Paste your Discord bot's application id into Settings:
Screenshot 2024-06-30 214723

Turn on Server Members Intent on the Bot tab:
image

Press Reset Token and copy the token from the Bot tab:
Screenshot 2024-06-30 214012

Paste your Discord bot's token into Settings:
Screenshot 2024-06-30 214755

Invite the bot to your server(s) first check the applications.commands and bot boxes in the OAuth2 URL Generator section of the OAuth2 tab:
Screenshot 2024-06-30 214508

Copy the GENERATED URL paste it into your browser's navigation bar:
Screenshot 2024-06-30 214536

Select a server to add the bot to and click Authorize:
Screenshot 2024-06-30 215705

Press Create new token at https://start.gg/admin/profile/developer and copy the start.gg token:
Screenshot 2024-06-30 215139

Paste your start.gg token into Settings:
Screenshot 2024-06-30 220241

Finally, select a tournament and event. This can be a past tournament or a test tournament, as long as it requires Discord connection and has entrants. If everything is set up correctly, the Discord bot will connect:
Screenshot 2025-12-07 at 13 47 01

Now verify that your bot has joined your server and you can use the /reportset command (I had to refresh Discord the first time for the command to show up):
Screenshot 2024-07-01 at 10 38 06 PM

Issues

Please check discussions/ask for help before checking issues/filing a bug report or feature request.

Development

Clone the repo and install dependencies:

git clone https://github.com/jmlee337/discord-tournament-bot.git discord-tournament-bot
cd discord-tournament-bot

I use Node 20

nvm use 20
npm install

Start the app in the dev environment:

npm start

To package apps for the local platform:

npm run package

About

Nicolet's Netplay Tournament Suite (NTS)

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published