discord.js

What is discord.js?

discord.js is a powerful Node.js module that allows you to interact with the Discord API very easily. It provides a comprehensive set of features to create bots and manage Discord servers.

What are discord.js's main functionalities?

Creating a Bot

This code demonstrates how to create a simple Discord bot using discord.js. The bot logs 'Ready!' to the console when it is successfully logged in and ready.

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.once('ready', () => {
  console.log('Ready!');
});
client.login('your-token-goes-here');

Handling Messages

This code shows how to handle messages in a Discord server. When a user sends a message with the content '!ping', the bot responds with 'Pong!'.

client.on('messageCreate', message => {
  if (message.content === '!ping') {
    message.channel.send('Pong!');
  }
});

Managing Roles

This code demonstrates how to manage roles in a Discord server. When a user sends a message with the content '!addRole', the bot adds a role named 'NewRole' to the user.

client.on('messageCreate', async message => {
  if (message.content === '!addRole') {
    let role = message.guild.roles.cache.find(r => r.name === 'NewRole');
    if (role) {
      await message.member.roles.add(role);
      message.channel.send('Role added!');
    }
  }
});

Sending Embeds

This code shows how to send embedded messages in Discord. When a user sends a message with the content '!embed', the bot responds with a rich embed message.

const { MessageEmbed } = require('discord.js');
client.on('messageCreate', message => {
  if (message.content === '!embed') {
    const embed = new MessageEmbed()
      .setTitle('Sample Embed')
      .setDescription('This is an example of an embed message')
      .setColor(0xff0000);
    message.channel.send({ embeds: [embed] });
  }
});

Other packages similar to discord.js

eris

Eris is another powerful library for interacting with the Discord API. It is known for being lightweight and efficient, making it a good alternative to discord.js. However, it may have a steeper learning curve for beginners.

discord.io

discord.io is a small, lightweight library for interfacing with Discord. It is less feature-rich compared to discord.js and Eris, but it can be a good choice for simpler bots or for those who prefer a minimalistic approach.

README

discord.js

discord.js is a node module used as a way of interfacing with Discord. It is a very useful module for creating bots.

Updating to 3.1.1 is essential as it has new changes to be compatible with Discord's API, and to make sure your application still works an update is a good idea.

Installation

npm install --save discord.js

---

Example

var Discord = require("discord.js");

var mybot = new Discord.Client();

mybot.on("message", function(message){
	
	if(message.content === "ping")
		mybot.reply(message, "pong");
	
});

mybot.login("email", "password");

---

Related Projects

Here is a list of other Discord APIs:

Java:

Discord4J

.NET:

Discord.Net

DiscordSharp

NodeJS

node-discord (similar to discord.js but lower level)

PHP

DiscordPHP

Python

discord.py

Ruby

discordrb

---

Changes in 3.1.4

No, not π. But instead, pseduo-synchronous messaging was added! This means that you can tell your Client to make a queue of "actions" per channel, and it will work through them one by one. This is a really useful tool if you need to send messages in a specific order without callback hell.

It also allows you to store responses - such as created messages - in the returned promise - named action. Example:

var mybot = new Discord.Client({
    	queue : true //enable queueing, disabled by default
});

mybot.on("message", function(msg){
	
	mybot.sendMessage(msg.channel, "this is message 1");
	var action = mybot.sendMessage(msg.channel, "this is message 2");
	mybot.sendMessage(msg.channel, "this is message 3").then(rmv);
	
	function rmv(){
	    if(!action.error){
			mybot.deleteMessage(action.message);	
		}	
	}
	
});

This is still in development, and will see many more enhancements in future.

---

Links

Documentation

GitHub

Wiki

Website

NPM

---

Contact

If you would like to contact me, you can create an issue on the GitHub repo or send a DM to hydrabolt in Discord API.