Discord Slim
Lightweight Discord client for Node.js.
Provides access to Discord client gateway and API for bots.
Very minimalistic way without excessive abstractions and dependencies. Also with very low resources usage.
Before you start
Node.js 12+ is required!
Make sure you have some understaning of Discord API.
API
Client
- main client class.
Methods
Auth(token)
- set up token for the client.Connect(intents?)
- connect to the gateway to receive intents.Disconnect()
- disconnect from the gateway.Request(method, route, data?, auth?)
- send a request to Discord API.WsSend(data)
- send data to the gateway directly.
?
means optional arg.
Events
connect
- client established a connection to the gateway.disconnect
- client disconnected.packet
- intent packet received.warn
- other noticeable information.error
- error appeared, client will continue to work.fatal
- fatal error, client will shutdown.
Other exports
Host
- contains current Discord domain.
API
- contains current Discord API address.
CDN
- contains current Discord CDN address.
Routes
- base API route constructors.
Permissions
- list of known permissions.
Intents
- list of known intents.
Installation
npm i discord-slim
Basic bot setup example
const Discord = require('discord-slim');
const client = new Discord.Client();
client.Auth('BOT_TOKEN');
client.Connect(Discord.Intents.GUILDS | Discord.Intents.GUILD_MESSAGES);
client.on('packet', packet => {
if(packet.t == 'MESSAGE_CREATE')
HandleMessage(packet.d);
});
You can read about possible intents here and here.
Scripting and routing
Auth
and Connect
functions are separated because API requests doesn't actually require connection to the gateway. This is useful if you want only a script that just sends some requests without actual client connection.
const Discord = require('discord-slim');
const client = new Discord.Client();
client.Auth('BOT_TOKEN');
const Routes = Discord.Routes;
client.Request('POST', Routes.Channel('CHANNEL_ID') + '/messages', { content: 'Hello!' });
Message posting example
Build from source
Install typescript
package from npm
and run tsc
.