A beginner's guide to configuring a Discord Bot in Node.js (2024)

Hi guys! Welcome to the tutorial on building your own Discord bot using Node.js. The article is aimed at beginners and provides step-by-step instructions on how to create a Discord bot and covers topics such as setting up a development environment, installing dependencies, and implementing basic functionality using Node.js. As Discord bots are growing in popularity each day, we are happy to share some knowledge that will help you put them to good use.

Node.js Discord Bot Prerequisites:

A code editor (e.g. Virtual Studio Code)
Some experience with JS 🤗
Node and npm installed on your machine
A configured Discord server

The Easiest CI/CD Tool to build, test and deploy your Node.js application.

Try Buddy for Free

Part 1: Discord configuration

#1: Create application in Discord

The first step in building a Discord bot, is creating an app in the Discord service. Sign in to your Discord account, go to the Discord's Developer Portal and create (or log in to) a developer account.

Next, click the New Application button:

Creating an app in Discord

Fill in the details of your app (name etc.) and proceed to the app's dashboard. Look up Bot on the settings list and click Add Bot to switch your app to bot mode.

Adding a new Discord bot

Once you do it, you'll get a confirmation on a nice green padding and a new expanded section at the bottom. Click the Copy button to save the bot token to the clipboard – we shall need it a couple of steps later

Discord bot details

As harmless as it seems, do not share or upload your bot token as it allows unrestricted access to your bot and server.

#2: Install bot to Discord server

Before you proceed, make sure you have a server on which you can install the bot.

Part 2: Developing bot with Node

All source code written in this guide is available at https://github.com/buddy-works/tutorials-discord-bot-node.

#1: Create project folder

Time to breathe some life into our bot creature. Let's start with creating a folder and initializing Node:

mkdir discordBotcd discordBotnpm init

#2: Install packages

Our little fella requires a couple of packages to function:

discord.js – a Node.js module which allows interactions with the Discord API
axios – allows to easily make HTTP Promises with Node.js
dotenv – allows to load environment variables from a process.env file in Node apps

Run the following command to install the packages:

npm install discord.js axios dotenv

#3: Configure index.js

Now we need an index.js file to host the functions of our bot.

In the project directory, run:

touch index.js

At the moment, the bot in your server is offline. To log in, you need a Discord bot client.

Paste the script below to index.js to import the discord.js package and create a new client:

require('dotenv').config(); //initializes dotenvconst Discord = require('discord.js'); //imports discord.jsconst client = new Discord.Client(); //creates new clientclient.on('ready', () => { console.log(`Logged in as ${client.user.tag}!`);});//this line must be at the very endclient.login(process.env.CLIENT_TOKEN); //signs the bot in with token

Surely, you have noticed CLIENT_TOKEN in the script? It means you can finally open your clipboard and paste the token that you copied in step one. Or go to your app details and copy the token again.

Part 3: Adding bot commands

#1: Writing your first bot command

The bot is now online – and eager to play. Let's start with something simple: a game of ping-pong with your Discord application. In other words: when you say ping, the bot will respond with "Pong!". Not much of an exciting message content, but hey – it's some start!

Add the following code block above the client.login(process.env.CLIENT_TOKEN); line:

client.on('message', msg => { if (msg.content === 'ping') { msg.reply('Pong!'); }});

When done, run node index.js again.

Next, type ping on your server. The bot should nowreply with "Pong!":

Playing ping-pong with Discord bot

Congratulations! You are one step closer to developing your own personal Chat GPT. 😁

#2: Fetching images from API

Let's face it: a bot replying 'pong' to a 'ping' is not the peak of usability. And what is useful for a bot user, you ask? Well, memes of course!

Our next step will be configuring the bot to fetch a random meme image from the API whenever you type !meme in the prompt.

It is a common practice to mark commands for bots with an exclamation mark at the beginning.

For the API, we shall use a simple Python-based MemeAPI by jaychandra. Once a call to the API is made, it returns a data object. Here's how it looks in a text editor:

{ memes: [ { author: 'PurpleRaspberri', nsfw: false, subreddit: 'memes', title: 'True story', upvotes: 72358, url: 'https://i.redd.it/7lygjwhq1qa61.jpg' } ]}

What we need from the data is the url property, so it can appear as an image in Discord. For this we need a proper function – let's call it getMeme(). Here's what it looks like in index.js:

//add this function below client.on... lineasync function getMeme(){ const res = await axios.get('https://memeapi.pythonanywhere.com/'); return res.data.memes[0].url;}

You can see the function requires Axios, an HTTP client for Node.js. Add this line at the top of the line to import it:

const axios = require('axios'); //add this line at the top

With everything in place, we can add the new !meme command to our client.on() function.

To keep the code clean, we use switch statements instead of if blocks.

client.on('message', async msg => { switch (msg.content) { case "ping": msg.reply("Pong!"); break; //starting meme command case "!meme": msg.channel.send("Here's your meme!"); //the reply to the user command const img = await getMeme(); //fetches the URL from the API msg.channel.send(img); //sends the image URL to Discord break; }})

As you can see, typing !meme will make the bot to post "Here's your meme!" on the server, then fetch the image URL using the the getMeme() function, and, finally, send the image using msg.channel.send(img) and display it in the message content.

Here's how it works in practice:

Fetching memes like a boss

Now that's a proper way to employ Discord bots!

#3: Sending messages on time intervals

Okay, the memes are working. But did you know you can make the bot send you messages at time intervals? Let's turn the bot into our personal health assistant by having it send us a message to take a break from the computer every hour.

First, configure an !eye command to let people subscribe to eye-break reminders:

let interval;client.on('message', async msg => { switch (msg.content) { //other commands above here... case "!eye": msg.channel.send("You are now subscribed to Eye-Break Reminders."); interval = setInterval (function () { msg.channel.send("Please take an eye break now!") .catch(console.error); }, 3600000); //every hour break; }})

At the moment, setInterval is set to 3600000 milliseconds, which equals one hour. Let's cut it down to 3 seconds (3000) to see if it actually works:

Recurrent messages on Discord server

All good! However, we don't want these reminders to pop up infinitely, right? What if we want it to stop? A !stop command calling clearInterval() should do just fine:

//add this below the "!eye" case block case "!stop": msg.channel.send("I have stopped eye reminders."); clearInterval(interval); break;

You can learn more about setInterval and clearInterval methods, at this site.

One last test if everything works fine. Looks like it does:

Testing stop command

Extra: You can learn about interacting with bots using slash commands in the Discord chat here.

Conclusion

There are numerous fascinating possibilities when it comes to utilizing Discord bots, including those that employ databases, environment variables, and more advanced interactions with the Discord API. I encourage you to explore the Discord Developer documentation and the discord.js documentation to delve deeper into the subject and create your own unique Discord bot according to your imagination.

Thank you for taking the time to read this. I hope this introduction has provided some valuable insights of developer know-how. If you found it helpful, please consider showing your support by liking or sharing this article to help spread the knowledge. 🤗