Skip to content

A powerful JavaScript library for interacting with the Discord API

License

Notifications You must be signed in to change notification settings

helperdiscord/discord.js

This branch is 3363 commits behind discordjs/discord.js:main.

Folders and files

NameName
Last commit message
Last commit date
Jan 27, 2021
Dec 14, 2020
Nov 22, 2020
Jan 27, 2021
Jan 27, 2021
Jan 27, 2021
Dec 14, 2020
Apr 19, 2017
Dec 31, 2020
Dec 31, 2020
Dec 14, 2020
Dec 31, 2020
Dec 8, 2020
Feb 29, 2020
Dec 30, 2020
Dec 30, 2020
Apr 4, 2020
Mar 21, 2020

Repository files navigation


discord.js


Discord server NPM version NPM downloads Build status Dependencies Patreon

npm installnfo

Table of contents

About

discord.js is a powerful Node.js module that allows you to easily interact with the Discord API.

  • Object-oriented
  • Predictable abstractions
  • Performant
  • 100% coverage of the Discord API

Installation

Node.js 14.0.0 or newer is required.
Ignore any warnings about unmet peer dependencies, as they're all optional.

Without voice support: npm install discord.js
With voice support (@discordjs/opus): npm install discord.js @discordjs/opus
With voice support (opusscript): npm install discord.js opusscript

Audio engines

The preferred audio engine is @discordjs/opus, as it performs significantly better than opusscript. When both are available, discord.js will automatically choose @discordjs/opus. Using opusscript is only recommended for development environments where @discordjs/opus is tough to get working. For production bots, using @discordjs/opus should be considered a necessity, especially if they're going to be running on multiple servers.

Optional packages

  • zlib-sync for WebSocket data compression and inflation (npm install zlib-sync)
  • erlpack for significantly faster WebSocket data (de)serialisation (npm install discord/erlpack)
  • One of the following packages can be installed for faster voice packet encryption and decryption:
  • bufferutil for a much faster WebSocket connection (npm install bufferutil)
  • utf-8-validate in combination with bufferutil for much faster WebSocket processing (npm install utf-8-validate)

Example usage

const Discord = require('discord.js');
const client = new Discord.Client();

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

client.on('message', msg => {
  if (msg.content === 'ping') {
    msg.channel.send('pong');
  }
});

client.login('token');

Links

Extensions

Contributing

Before creating an issue, please ensure that it hasn't already been reported/suggested, and double-check the documentation.
See the contribution guide if you'd like to submit a PR.

Help

If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle nudge in the right direction, please don't hesitate to join our official Discord.js Server.

About

A powerful JavaScript library for interacting with the Discord API

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 99.8%
  • TypeScript 0.2%