What is a Discord Bot? | Statbot (2024)

A "Discord Bot" refers to a user-like member of your server that you can use to automate various actions. It's denotedby a "Bot" tag next to its name. Bots use Discord's public "API" to do actions like send messages, modify roles, etc.

How to Use Bot Commands​

Commands are the various operations that you can have a bot perform through sending messages in Discord. Statbot'scommands primarily focus on displaying stats and configuring settings. It supports both Slash and Prefix commands.

Slash​

Most common for Discord bots these days, you can access commands you have permissions to run by first typing a /forward-slash in a channel. This will prompt you with the commands you can run in that channel—narrowing resultsas you type more characters.

Example: /me

Note that just because a member can see a Slash command does not mean that they'll always be able to run it.Statbot's advanced RBAC system will always enforce permissions restrictions.

Prefix​

Prefix commands are ones where a bot searches the beginning of a message for a set of characters. It uses thisto know if the the message contains a command that it needs to run. In regards to commands, Statbot ignoresmessages that don't start with the server's prefix or @Statbot.

Statbot's default prefix is s? (not case-sensitive) with full support for /slash commands. You can also use@Statbot instead of the prefix, which is helpful if you ever forget your prefix and want to check it in Discordrather than the Dashboard.

Below are some examples of Statbot commands illustrating how a prefix is used:

Setting a custom prefix for your server is covered later in this guide under 5. Common Settings.

Aliases​

An Alias is a command that acts as a shortcut for another. For example, one of the Aliases forthe stats messages command is m, so s?stats messages and s?m return the same output. Aliases accept thesame Parameters as the full command. (e.g. s?u @User)

Privileged Commands​

Privileged Commands (aka: "Admin Commands") are commands that require you to have certainDiscord permissions or Role-Based Access Control (RBAC)overrides. By default, members with the Administrator or Manage Server Discord permissions can edit all Statbotsettings—with the only one exception being theElevate Manage Server setting.

Required Permissions​

Information on what Discord permissions are required by features. This is a more in-depth version of the previous guidepage.

Tracking​

The following Discord permissions are required to track stats:

• Read Messages — Required on text channels to track sent messages and see commands.
• See Channel — Required on voice channels to track voice minutes and update Statdock channel counters.

Responding to Commands​

The following Discord permissions are required to respond to commands in Discord:

• Send Messages — Required to send any response.
• Embed Links — Required to send responses. All commands use tidy embeds which use this permission.
• Attach Files — Required for commands that send graphs and .csv files.
• Read Message History — Required only for Prefix commands.

Statroles​

The following permission is required for the Statroles feature:

• Manage Roles — Required to assign and remove roles to/from members.

Statroles rely on stats tracked by the bot, so make sure that the bot has the permissions noted above on the channelsyou want stats for.

Statdocks​

The following are required for the Statdocks feature:

• Manage Channels — Required to both create and manage channels.
• View Channel (aka: See Channel) — Required to both create and manage channels.
• Connect — Required to create and manage channels (including channel name).
• Send Messages — Required to create Statdocks.

User Privacy​

Finally, because of the importance that Discord places on this topic, it is worth highlighting the/privacy command. This command allows a user to anonymize their stats across all servers. This process was explainedearlier in the Welcome page's section about privacy.

When turning on User Privacy, you will be sent the following message and prompted for confirmation:

We greatly value your privacy. By activating User Privacy, we will anonymize your message and voicedata. Users are limited to toggling this setting only once every 24 hours. After toggling User Privacy"On", a process will begin to anonymize all of the aforementioned data. The entire process can takesome time to complete and once started, can not be stopped. You will receive a notification on thiswebsite letting you know when you have been successfully anonymized.

By anonymizing your data, Statbot may not be able to accurately determine your activity in a serverwhen executing services like Smart Prune and Statroles. Anonymizing your data may result in decreaseduser experience. If you understand and wish to continue...

Technical Stuff​

Shard​

Without going into the complicated details, Discord has large bots connect to it over many connections so that it cansplit events between them. All of a bot's servers (like the one you've added Statbot to) are divided amongst theseconnections. A Shard refers to one of these connections. Typically, a Shard for Statbot will have 1,000 or soservers on it.

This is useful to know because sometimes parts of Discord's API or the bot may go offline, but that doesn't necessarilymean that the entire bot is down.