Proposal: Expose Shards property from GetBotGatewayResponse object in some way.

[Seeker1437]

Because of the way I have been developing my bot, I wanted it from the very beginning to be able to retrieve the correct shard count recommended by discord. During the login process the data is retrieved but it is not exposed in the public API.

I would like to propose exposing this property or it's data in the public API in someone wanted to use it when starting their shards manually without using the DiscordShardedClient object.

If this does not fit the "meta" is there an alternative method I can use to acquire this information myself?

[shikhir-arora]

When your bot is under 100,000 guilds, you have some flexibility with shard counts. 2,500 guilds/shard is the enforced limit by Discord, but this is higher than you'll see almost anyone do - realistically 1,000-1,800 guilds per shard is what I've seen. You can calculate this by just taking the total guilds your bot has or theoretically will, finding a good guild/shard number and dividing.

If you mean which guild will go to what shard, as messages (DMs) are sent to shard 0 only, the formula:

(guild_id >> 22) % num_shards == shard_id

will give you the shard_id -- after you exceed 100,000 guilds, however, Discord will contact you and assign a number of shards based on your bot. This is only for those very large bots.

[foxbot]

@shikhir-arora no, Discord provides an endpoint to calculate the recommended number of shards for you - he's just asking us to expose that endpoint in the library.

[Seeker1437]

I guess I did it wrong is just linking my PR here haha, #962

[AntiTcb]

Gotta leave a "fixes/resolves #962" in either the commit message or PR description, not the title for it to do that automagically. https://help.github.com/articles/closing-issues-using-keywords/

[Seeker1437]

Updated :D