Skip to content

Modular discord gateway library for microservice oriented bots

License

Notifications You must be signed in to change notification settings

DasWolke/CloudStorm

Repository files navigation

A minimal discord gateway library

Part of the WeatherStack

CloudStorm is a small library specially made to only cover the Gateway area of the discord api.

It makes no assumptions about the rest of your stack, therefore you can use it anywhere as long as you use node 14 or higher.

Some of the things that make CloudStorm awesome:

  • Standalone discord gateway connection
  • zlib-stream, etf and json support
  • Well documented

Example:

const { Client } = require("cloudstorm");
const bot = new Client(token, { intents: ["GUILDS"] });
const startup = async () => {
	await bot.connect();
	bot.on("ready", () => console.log("Bot received ready event"););
};
startup().catch(e => {
	console.error("Error on startup!");
	console.error(e);
});

Gotchas with CloudStorm:

You may wonder how you you are able to get the id of a shard where an event originated from, but don't fear, CloudStorm helps you with that by adding a shard_id property to the events that are forwarded.

So an event you receive may look like this:

{
	"op": 0,
	"t": "PRESENCE_UPDATE",
	"s": 1337,
	"shard_id": 0,
	"d": {
		"user": {
			"id": "id"
		},
		"guild_id": "id",
		"status": "offline",
		"activities": [],
		"client_status": {}
	}
}

Sharding for VERY large bots

CloudStorm supports max_concurrency and gets this info on initial connect, but does not automatically attempt to fetch new info related to max_concurrency. You are expected to re-fetch this data at your own discretion as Discord does not recommend caching the data for extended periods as it can change as your client leaves and joins guilds and possibly cause rate limit errors.

You should start your clusters 1 by 1 as rate limit info is only fetched on Client.connect or when you manually call Client.fetchConnectInfo when /gateway/bot is fetched

Microservice Bots:

I've written a general whitepaper on the idea of microservice bots, which you can find on gist: Microservice Bot Whitepaper

Documentation:

You can find the docs at https://daswolke.github.io/CloudStorm/

Installation:

To install CloudStorm, make sure that you have node 14 or higher on your computer.

Then run the following command in a terminal npm install cloudstorm

About

Modular discord gateway library for microservice oriented bots

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published