Content

Article Overview

Preface: Statdocks are what most people know as as Discord “Channel Counters”; however, the name is different for a reason. Statdocks may contain multiple counters, such as a Statdock that contains counters for Online, DnD, and Idle counts separately. “Statdock” will refer to the resultant channel text and the configurations, while “Counter” will refer to a specific stat in a Statdock.

What is a Statdock?

Statdocks are Discord voice channels that display various information. The result is something similar to “hoisting” roles in a server, but using information and stats about the server instead. There are currently 16 “Counter Types” which you’ll find explained further down the page. These Counter Types can be mixed and matched into a Statdock’s Channel Text, with up to 4 counters allowed to be added per Statdock. Configuring these through the website will allow you to see a Preview with estimated channel lengths for Desktop and Mobile to make sure your Statdock text isn’t too long without the need for trial and error.

Example of Statdock Discord channel counters
Example. Counter Types from top to bottom:
Date & Time, Members, Members (with countdown), 3 Status counters, Members in Role (with online, dnd, or idle status).

Limitations

Because of Discord limitations, each server is given a set amount of updates their Statdocks can make per 24 hours. The number of updates a server has left in this period is called “Quota”. A quota is used when the bot changes the name of the channel. This may happen automatically depending on your Check Frequency setting for each Statdock, and may also happen when you update a Statdock from the dashboard, or run the `statdocks update` command in Discord. The Check Frequency setting on each Statdock allows you to control how frequently each Statdock updates so that you can make sure important ones are updating at the speed you want.

Example of Statdock quota visible in dashboard

When your server runs out of quota, automatic updates will stop until the reset time shown here. Quota Per Day (as seen on the dashboard) will decrease over time as more servers use Statdocks. Be sure to check your Mange > Statdocks dashboard page or run the `statdocks quota` command in Discord regularly to see if you are running out.

Each server can have up to 50 Statdocks. Each Statdock may have up to 4 counters. Premium counters are limited to update at most every hour.

Create a Statdock

Statdocks can be a little confusing at first, but with this guide you’ll be creating all the custom channel counters you want exactly how you want them!

After navigating to the Manage page of your server on https://statbot.net, you’ll want to click on “Statdocks”. After that, you’ll be greeted with a screen similar to the screenshot below. Click “+ Add” to create your first Statdock!

Statdock configuration page
View of Statdock creation modal including the text for the Discord channel counters

Basic Settings

  • Name (Optional) – This only for you and will help you identify this Statdock in the list.
  • Channel Text – This is the text that will be in the Discord channel name and also where you will insert counters. You can click on counters in this box to open them up in the Builder and edit them. The dropdown will show some easy-access symbols you can add. Any character Discord supports can be pasted into this field.
  • Insert Counter(s) – These menus will present you with the different options for counters. Presets gives you a set of preset where able. Some Counter Types may redirect you to the Builder because they cannot be made with preset information. Builder gives you full access to all the different configurations you can make for counters.
  • Preview – This will allow you to preview your Statdock without creating it. When adding counters, “Test Text” boxes will appear for each allow you to add in values you expect to appear for them. Checking “Show Limits” will give you approximate limits for a Discord channel name. Discord cuts the text off after it exceeds a certain length, this differs from device to device.
  • Check Frequency – How often the bot will check for a change in counter values. Remember: A quota will not be used if the channel text does not need to be updated (i.e. the channel name hasn’t been manually altered and the values for the counters haven’t changed).

When you go to save the Statdock, the bot will attempt to make the channel. If it is unable, it will let you know what’s wrong and you’ll be given a chance to save the configuration even without the Discord channel. Otherwise, it will create the channel and you’ll be able to move it wherever you want in the Discord server. Be sure to mind the permissions and make sure Statbot has the “Manage Channel”, “See Channel”, and “Connect” permissions for each Statdock in order to update them.

Counter Types

In order to reduce the complexity of this article, only a brief explanation of each counter type and some common functions will be listed here. You are encouraged to click around the UI and explore the different configurations!

View of Statdock configuration builder menu

Regular Types

  • Activity Members – Members in the server interacting with a list of activities. Activities you list here must be exactly what Discord displays. You can use the s?show activity <user> command on a users interacting with the activity to get the name.
  • Activity Type Members – Member in the server with a certain status from: Playing, Streaming, Watching, and Listening
  • Channels – Count of channels in the server.
  • Countdown / Timer – A countdown to a specific date and time. Can be configured to show any combination of Minutes, Hours, and Days. Omitting a lower timeframe will cut it off. Has a preview box that you can use to see what it will look like.
  • Date & Time – Exactly as it sounds. Allows advanced formatting with dayjs and dayjs extended. Has a preview box that you can use to see what it will look like.
  • Members – Count of members in the server.
  • Members with Status – Count of members with specific Discord status(es) (Online, DnD, Idle, Offline) in a server.
  • Members in Role – Count of members in role(s). Additionally can specific a status and it will only display members in that role(s) with those status(es).
  • Roles – Count of roles in the server.
  • Voice – Count of members in voice channels. Can whitelist / blacklist channels or leave blank for all channels.

Premium Types

  • Stat Count – Sum of Statbot stats.
  • Stat Average – Average of Statbot stats over time.
  • Stat Change – Change of Statbot stats from one time period to the next.
  • Stat Top – Top member or channel determined with Statbot stats.
  • Reddit Subscriber Count – Subscriber count of a Subreddit.
  • YouTube Subscriber Count – Subscriber count of a YouTube channel. YouTube subscriber count is rounded to, at most, 3 significant digits. This is a limitation of YouTube itself. How to find your Channel ID.

Check Frequency

This setting controls how often the bot will check the values in a Statdock against the channels name. During a check, if the values in the Statdock are different than the channel text then an update will occur and a quota will be used. Automatic updates will stop occurring when the server runs out of quota for a day, at which point the server will need to wait until reset. Currently, you can use four different intervals for checking Statdocks; however, more are planned for the future for more flexibility.

(De)Activating

Statdocks can be deactivated and reactivated. Deactivating a Statdock will delete the Discord channel and stop the bot from checking the Statdock text. This allows to you remove a Statdock without needing to completely delete it. This can be useful for Countdown counters and others where you might want to re-use some settings you have in the future. Deleting a Statdock’s Discord channel will automatically deactivate the Statdock.