A custom version of the Discord.js library, with better support for presences.
This library is a fork of discord.js, 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
Additional features provided by this library:
- Improves detection of user presence updates
- Greatly reduces presence caching without compromising presence update detections when sweepers are implemented.
- Continues to support the EmbedBuilder.addField() method.
Node.js 16.9.0 or newer is required.
``sh-session`
npm install discord.js
yarn add discord.js
pnpm add discord.js
- zlib-sync for WebSocket data compression and inflation (npm install zlib-sync)npm install discord/erlpack
- erlpack for significantly faster WebSocket data (de)serialisation ()npm install bufferutil
- bufferutil for a much faster WebSocket connection ()bufferutil
- utf-8-validate in combination with for much faster WebSocket processing (npm install utf-8-validate)npm install @discordjs/voice
- @discordjs/voice for interacting with the Discord Voice API ()
Install discord.js:
`sh-session`
npm install discord.js
yarn add discord.js
pnpm add discord.js
Register a slash command against the Discord API:
`js
const { REST, Routes } = require('discord.js');
const commands = [
{
name: 'ping',
description: 'Replies with Pong!',
},
];
const rest = new REST({ version: '10' }).setToken(TOKEN);
(async () => {
try {
console.log('Started refreshing application (/) commands.');
await rest.put(Routes.applicationCommands(CLIENT_ID), { body: commands });
console.log('Successfully reloaded application (/) commands.');
} catch (error) {
console.error(error);
}
})();
`
Afterwards we can create a quite simple example bot:
`js
const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.on('ready', () => {
console.log(Logged in as ${client.user.tag}!);
});
client.on('interactionCreate', async interaction => {
if (!interaction.isChatInputCommand()) return;
if (interaction.commandName === 'ping') {
await interaction.reply('Pong!');
}
});
client.login(TOKEN);
``
- [Website][website] ([source][website-source])
- [Documentation][documentation]
- [Guide][guide] ([source][guide-source])
See also the [Update Guide][guide-update], including updated and removed items in the library.
- [discord.js Discord server][discord]
- [Discord API Discord server][discord-api]
- [GitHub][source]
- [npm][npm]
- [Related libraries][related-libs]
- [RPC][rpc] ([source][rpc-source])
Please refer to the official discord.js repository and server for help.
[website]: https://discord.js.org/
[website-source]: https://github.com/discordjs/discord.js/tree/main/apps/website
[documentation]: https://discord.js.org/#/docs
[guide]: https://discordjs.guide/
[guide-source]: https://github.com/discordjs/guide
[guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
[discord]: https://discord.gg/djs
[discord-api]: https://discord.gg/discord-api
[source]: https://github.com/discordjs/discord.js/tree/main/packages/discord.js
[npm]: https://www.npmjs.com/package/discord.js
[related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
[rpc]: https://www.npmjs.com/package/discord-rpc
[rpc-source]: https://github.com/discordjs/RPC
[contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md