mirror of
https://github.com/discordjs/discord.js.git
synced 2026-03-09 16:13:31 +01:00
7e9e7c39c00507d8fb129b7090c6f47a0ab54dd2
discord.js
Discord.js is a node module that allows you to interface with the Discord API for creation of things such as bots or loggers.
The aim of this API is to make it really simple to start developing your bots. This API has server, channel and user tracking, as well as tools to make identification really simple.
For more information, click here.
Installation
npm install discord.js
Example usage
/*
* A basic bot that shows how to connect to a Discord account,
* how to listen to messages and how to send messages.
*
* This bot responds to every "ping" message with a "pong".
*/
var Discord = require( "discord.js" );
// Create the bot
var myBot = new Discord.Client();
// Login with an example email and password
myBot.login( "hello@example.com", "password1" );
// The "ready" event is triggered after the bot successfully connected to
// Discord and is ready to send messages.
myBot.on( "ready", function() {
console.log( "Bot connected successfully." );
} );
// Add a listener to the "message" event, which triggers upon receiving
// any message
myBot.on( "message", function( message ) {
// message.content accesses the content of the message as a string.
// If it is equal to "ping", then the bot should respond with "pong".
if ( message.content === "ping" ) {
// Send a message ("pong") to the channel the message was sent in,
// which is accessed by message.channel.
this.sendMessage( message.channel, "pong" );
}
} );
TODO
- Documentation
- Better error handling
- Being able to cache new servers and channels as well as ones that are deleted - this is currently only done when a bot is created
Description
Languages
TypeScript
61.1%
JavaScript
28.5%
MDX
10.1%
CSS
0.2%