Skip to content
aoi.js

Client Sharding

Written by

As a bot developer, you may have experienced some limitations when scaling up your Discord bot to serve a large number of users. Discord imposes a maximum limit of 2,500 guilds per bot, and if your bot exceeds this number, Discord enforces a sharding to split portions of your bot into separate processes.

Sharding is an effective way to distribute your bot’s workload across multiple servers, which can greatly enhance the bot’s performance and reduce the strain on any single server. Once you’ve reached the 2500-guild limit, Discord requires that you shard your bot in a way that allocates no more than 2500 guilds per shard.

To make the sharding process easier for bot developers, aoi.js provides built-in support for sharding. Developers can split their bot’s workload into smaller, more manageable parts, each of which runs in its own separate process. The recommended number of guilds per shard is around 1000, but this can vary depending on your bot’s functionality and complexity.

One advantage of sharding is that it allows you to split your bot’s workload across multiple servers, which can reduce the processing load on any one server and make your bot more responsive. Additionally, sharding can be useful in scenarios where you need to run multiple instances of your bot for different users or groups of users.

In some cases, you may want some or all of your shards to be in the same process, allowing for a shared state. This is possible with aoi.js, which provides a flexible and powerful built-in handler for managing the sharding process. With the ability to split your bot’s workload across multiple processes, you can ensure that your bot runs smoothly, even as its user base grows over time.

aoi.js has the ClientShard class to handle Sharding for your Discord Bot, this works similar to the ShardingManager of discord.js.

1
new ClientShard(file, options);
ParameterTypeDescription
filestringPath to your main file
optionsstringOptions for the sharding manager

ParameterTypeDescription
tokenstringToken to use for automatic shard count and passing to shards
totalShardsstringNumber of total shards of all shard managers or “auto”
shardListstringList of shards to spawn or “auto”
modestringWhich mode to use for shards
respawnstringWhether shards should automatically respawn upon exiting
silentstringWhether to pass the silent flag to child process (only available when mode is set to ‘process’)
shardArgsstringArguments to pass to the shard script when spawning (only available when mode is set to ‘process’)
execArgvstringArguments to pass to the shard script executable when spawning (only available when mode is set to ‘process’)

Before we begin with the code, you must create two files.

One called index.js and another one with the name shard.js.

1
const { ClientShard } = require("aoi.js");
2


3
const sharder = new ClientShard("./index.js", {
4
    // Your main file, in this case called "index.js".
5
    token: "Discord Bot Token", // Your Discord Bot token.
6
    totalShards: 3 // The amount of shards/instances you want to create, in this case three.
7
});
8


9
sharder.on("shardCreate", (shard) => console.log(`Launched shard ${shard.id}`)); // Used for debugging, can be removed.
10
sharder.startProcess(); // Starts the sharding process.

Your index.js, also known as main file should look like the following (nothing changes..!):

1
const { AoiClient } = require("aoi.js");
2


3
const client = new AoiClient({
4
    token: "Discord Bot Token",
5
    prefix: "Discord Bot Prefix",
6
    intents: ["MessageContent", "Guilds", "GuildMessages"],
7
    events: ["onMessage", "onInteractionCreate"],
8
    database: {
9
        type: "aoi.db",
10
        db: require("@akarui/aoi.db"),
11
        dbType: "KeyValue",
12
        tables: ["main"],
13
        securityKey: "a-32-characters-long-string-here"
14
    }
15
});
16


17
// Ping Command Example (sharding)
18
client.command({
19
    name: "ping",
20
    code: `Pong! $guildShardPing[0]ms`
21
});

Then by running node shard.js you are able to start your bot.

Running node index.js will no longer work if you want to have sharding, use node shard.js.

This depends on the file name you have chosen for the sharding file.

  • $shard[option]
  • $guildShard[option?;sep?;shardId]
  • $guildShardID
  • $guildShardPing[shardId?]
  • $killShard[shardId]
  • $respawnAllShards
  • $spawnShard[amount]