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!

1. Preparation2. Creating a Project3. Creating a 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 v21
```

Create Your First Project

Start DBB. You will be greeted with this screen:

2, Click on Create New Project. You should now have this screen:: After these Steps, you now have a Temporary Project opened in which you can start creating your Bot.; To Make sure that you progress is not lost after a restart, you can save your Project by clicking on the Save Button in the Top Left Corner in the Project Menu.; Then, a Window Pops up in which you can go into the Folder you want to the Save the Project in and then also set a Project Folder name. After that you can click on Save.

Create a New Bot Account and Set it Up in DBB

Go to the Discord Developer Portal and do the following things:

Create a New Application with the name of your Choice
Go to "Bot", and click "Add Bot"
After that you go down and enable the 3 "Privileged Gateway Intents"
Disable Public bot, to make the bot only inviteable via the URL
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!)

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.

Now you need to invite the bot to your server. You can get a Link by Going into the Discord Developer Portal, selecting your Application, going to OAuth2, and then selecting the bot and application.commands(Slash Commands) scope. After that you can select the permissions you want to give the bot and then copy the link.

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.

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.

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

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

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!