Skip to content

Getting Started

This section will explain how to install NodeJS, setup a Bot Project within DBB as well as create and invite your Discord Bot!


Installing Node.js

In order to allow your bot to run, you will need to install Node.js:

Installing on Windows
  • Click here to download the installer for the LTS version of Node.js.
  • Follow the installer's instructions
Installing on Ubuntu via CLI
  • Copy these commands using the copy button in the top right hand corner of the box and paste them into your command line.
    curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
    source ~/.bashrc
    nvm install v18
    

Create Your First Project

  1. Start DBB. You will be greeted with this screen:
StartupScreen

2, Click on Create New Project. You should now have this screen:

CreateBotScreen

The 'Bot Folder Name' is the name of your project and the name of the folder that will contain your bot. The Bot Folder Path is the directory on your computer where the new folder containing your bot will be created.

In the example below, the bot will be saved in the folder "DBBProjects" in a new folder and with the project name 'MySpecialBot'

CreateBotScreen


Create a New Bot Account and Set it Up in DBB

Go to the Discord Developer Portal and do the following things:
  1. Create a New Application with the name of your Choice
  2. Go to "Bot", and click "Add Bot"
  3. After that you go down and enable the 3 "Privileged Gateway Intents"
  4. Disable Public bot, to make the bot only inviteable via the URL
  5. Copy the Bot Token and save it for later...
    (Note: MAKE SURE TO KEEP THE TOKEN SECRET AT ALL TIMES! IF SOMEBODY GETS THE BOT TOKEN, THEY CAN ACCESS AND ABUSE YOUR BOT!)

Gif

Input it into DBB. Do this by selecting the Bot menu in the toolbar at the top of the screen and selecting Set Bot Token. Then paste the token and hit Enter or click OK.

Image

Now you need to invite the bot to your server. Get an invite link by going to the Bot menu in the toolbar at the top of the screen and selecting Generate Invite.

CreateInviteInDBB

Then go to your web browser and paste the invite link there. Choose which server you want to invite the bot to and click Continue.

DiscordInviteStart

On the next page, a huge list of permissions will come up. Change them as you wish. Scroll down to the bottom (there will be some information about your bot) and click Authorize.

DiscordInviteStart

Finally, complete the reCAPTCHA, click Verify, and this message should display.

EndImageDiscordInvitePage

That means you're all set and the bot's now in your server.


Other Important Stuff

Important

Without an event, your command will never work! Events are the only blocks that have no "Action Connection" input since they get triggered by the bot itself.
Variable Types

Image

The line types must match to connect two blocks.

On the Output side of the block, there can be as many connections to one point as you like (except on the action type).

On the Input side of the block, there can always only be one connection per point.

Good to know

Server = Guild

User ≠ Member

A member is a user that is relevant to the guild only. You can execute actions to do with a specific server with a member.

Your turn!

Use these Examples, Tutorials and Infos to create your own Bot. Maybe you can even try to code your own Blocks and learn Javascript!