discord discord-bot discordjs distube javascript

🤖 DiCoBo 🤖

Overview

Permissions
Requirements
Server installation guide
Edit config file
Contributing
Contact
License

Set the correct permissions

When inviting the Bot make sure it has the following OAuth Scopes set in the Discord Developer Portal.

bot
applications.commands
Manage Roles
Manage Channels
Kick Members
Ban Members
Manage Nicknames
Read Messages/View Channels
Send Messages
Send Messages in Threads
Manage Messages
Embed Links
Attach Files
Read Message History
Use External Emojis
Add Reactions
Connect
Speak
Move Members
Use Voice Activity

Requirements

Nodejs>=18.15.0: Download
Git: Download
Discord Bot Token: Get it here
Discord Bot ClientId: Get it here

Server installation instructions

Windows

using CMD

Open CMD using WIN + R and type cmd and hit ENTER
Run git clone https://github.com/ballaual/DiCoBo.git
Run cd DiCoBo
Run npm i to install the required modules
Run cd config to navigate into the config folder
Copy or Rename config.json.example to config.json
Edit config.json - see here
Run cd .. to navigate into the root folder of the bot
Run npm start to start the bot

To update the bot run npm run update

without using CMD

Download latest release from here
Unzip the files using WinRAR or any other package manager
Navigate into the folder DiCoBo\scripts
Execute install.bat to install the required modules
Navigate into the folder DiCoBo\config
Copy or Rename config.json.example to config.json
Edit config.json - see here
Navigate into the folder DiCoBo\scripts
Execute startbot.bat to start the bot

To update the bot execute the update.bat

Linux

Debian >=10

As root: Create a new user useradd -m -s /bin/bash DiCoBo
Login as DiCoBo using su - DiCoBo
Run git clone https://github.com/ballaual/DiCoBo.git
Run cd DiCoBo
Run npm i to install the required modules
Run cd config to navigate into the config folder
Run cp config.json.example config.json
Edit config.json using nano or vim - see here
Run cd .. to navigate into the root folder of the bot
Run npm start to start the bot

To update the bot run npm run update

using systemd

Follow the guide from Debian installation guide until step 7
As root: Navigate to systemd's folder using cd /etc/systemd/system/
Create a new file called DiCoBo.service
Insert following code

[Unit]
Description=DiCoBo Discordbot
After=network.service

[Service]
User=DiCoBo
Group=DiCoBo
Type=simple
WorkingDirectory=/home/DiCoBo/DiCoBo/
ExecStart=node .
RestartSec=15
Restart=always

[Install]
WantedBy=multi-user.target

Run systemctl daemon-reload to reload systemd's configs
Run systemctl enable DiCoBo to enable autostart
Run systemctl start DiCoBo to start the bot

Note: From now on the bot will always run in background and will automatically start when the machine gets rebooted.
To stop the bot run systemctl stop DiCoBo
To disable the autostart run systemctl disable DiCoBo

Update the bot: cd /home/DiCoBo/DiCoBo/scripts && npm run update

Edit the config file

Please make sure to fill every field marked as *required because they are mandatory for the main functions of the bot! Otherwise the bot won't start and / or might crash at some point if these information are missing.