Building a Discord bot for beginners

Imagine running your own Discord community and noticing how repetitive some tasks can get — moderating chat, welcoming new users, or even automating responses to frequently asked questions. Instead of spending hours doing these tasks manually, what if a bot could take care of them for you? Building a custom Discord bot won’t just save you time, it’ll also make your server feel smart and polished. Let’s walk through the essentials of creating your first Discord bot, even if you’ve never touched code before.

Setting Up Your Environment

The first step to building your bot is preparing the tools you’ll need. For this, you’ll use Node.js (a JavaScript runtime) and the popular Discord.js library.

• Node.js: Download and install Node.js from https://nodejs.org/. Choose the Long-Term Support (LTS) version for stability.
• Code editor: Install a code editor like Visual Studio Code to write and debug your bot’s code.
• Discord developer portal: Create a bot application at the Discord Developer Portal. This will give you an API token to authenticate your bot.

Once Node.js is installed, open a terminal or command prompt and verify the installation using:

node -v
npm -v

If both commands return a version number, congratulations — Node.js is good to go! Next, create a folder for your bot and initialize a new project:

mkdir my-discord-bot
cd my-discord-bot
npm init -y

This will create a simple package.json file to manage your bot’s dependencies. Now install the Discord.js library:

npm install discord.js@v14

Writing Your First Bot

With your environment set up, you’re ready to begin coding. Create a new file in your project folder called index.js. This will be the main entry point for your bot. Start by requiring the Discord.js library and initializing a bot client:

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages] });

// Replace 'YOUR_BOT_TOKEN' with your actual bot token from the Discord Developer Portal
const TOKEN = 'YOUR_BOT_TOKEN';

client.once('ready', () => {
  console.log(`Logged in as ${client.user.tag}!`);
});

client.on('messageCreate', (message) => {
  // Ignore messages from bots
  if (message.author.bot) return;

  // Simple command: Respond to "!hello"
  if (message.content === '!hello') {
    message.channel.send('Hello! 👋');
  }
});

client.login(TOKEN);

What’s happening in this code? Let’s break it down:

• Client: You’re creating a client to interact with Discord’s API, specifying intents like listening to guilds and messages.
• Ready event: This triggers when the bot successfully logs in. It’s a great place to display a confirmation message.
• Message handling: The messageCreate event listens for new messages, and you filter out bot messages to avoid loops.
• Command matching: By checking the content of a message, your bot knows when to respond. Here, it reacts to the command !hello.

Run your bot using the following command:

node index.js

If everything is set up correctly, you’ll see Logged in as [BotName] in your terminal. Hop into your Discord server and type !hello — your bot should respond immediately!

Adding A Custom Command

Let’s make things slightly more interesting by adding another command. Imagine you wanted your bot to provide a random fun fact. You can achieve this with a simple array and a bit of JavaScript magic:

client.on('messageCreate', (message) => {
  if (message.author.bot) return;

  if (message.content === '!fact') {
    const facts = [
      'Honey never spoils.',
      'The Eiffel Tower can grow in height during summer.',
      'Bananas are berries, but strawberries aren’t.'
    ];

    const randomFact = facts[Math.floor(Math.random() * facts.length)];
    message.channel.send(randomFact);
  }
});

Add this code below the !hello command, and your bot will now respond to !fact with a random fun fact.

Go ahead and test it! Commands like this are the foundation of your bot. From here, you can explore more advanced features like embedding rich messages, reacting to user input, or even moderating your server.

Building a bot is an iterative process — you learn something from every tweak and feature you add. With just a few lines of code, you can surprise and delight your Discord community with automation that feels personal. So, grab your keyboard and start building — the possibilities are endless!