Statdocks (Channel Counters)

info

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 about your sever and its stats that Statbot has tracked! The result is something similar to “hoisting” roles in a server, but using information these stats instead.

There are currently 16 “Counter Types” but some others types are what other bots consider multiple counters, so you can think of Statbot having something like 50 counter types!

Renaming counters is completely free, so you're free to call them whatever you want! You can also add multiple Counters to single Statdock’s name, with a limit of 4 counters per Statdock!

This is made possible with the Website Configurator available on your server's dashboard under Manage > Statdocks which offers a way to effortlessly add, edit, and delete Statdocks and counters in them.

You can see just some of the many Statdocks you can make on the left. In order they are: 1. Date & Time | 2. Date & Time | 3. Members in Role (x2 + Status filters) | 4. Members in Role | 5. Members in Role | 6. Users | 7. Users (+ goal) | 8. Status (x3) | 9. Members in Role | 10. Activity Members | 11. Activity Type Members | 12. Stat Top (Premium) | 13. Stat Count (Premium) | 14. Stat Change (Premium) | 15. YouTube Subscriber Count (Premium)

Important Information

Each server can have up to 50 Statdock configurations. If you exceed this limit, you will need to delete some before creating more.

Each Statdock may have up to 4 counters. Premium counters are limited to update at most once every hour; however, the statdock update command may be used to update before the scheduled time if necessary.

Because of Discord rate limits, channels can only update twice every 10 minutes. The update command cannot update any faster than this either. This part of why 6 minutes is the lowest Check Frequency time available.

Super Important!

Servers without the Statdocks+ upgrade will have their counters update on a minute offset between 0 minutes and the interval on the Statdock (e.g. 10 minutes, 1 hour, etc).

For example, a server's may be on an offset of 3 minutes. Their counters will update a 1:03, 1:13, 1:23, etc. This offset may be different for every interval. With the Statdocks+ upgrade, those same counters will update at 1:00, 1:10, 1:20, etc.

Creating 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!

There are two ways to create Statdocks. The Bot offers a very quick and easy way to create preset Statdocks and Statdocks with a little bit of customization. The Website Configurator is more complex at first but offers much more flexibility and many more counter options. After you feel comfortable with the bot, we highly recommend you try out the website!

Requirements

If you have not already, invite Statbot and make sure it has the permissions: Read & See Channels, Manage Channels, and Connect; OR you can give it Administrator instead.

Bot

info

You can watch the video to see a walkthrough how to create Statdocks with the Discord bot. The information after it will walk through the same process.



After inviting the bot, you can use the s?statdocks setup command followed by y to create a few preset Statdocks in a new category. This is a great place to start to get some stats in your server and see it all working! If you want to delete any of them, just delete the channel.

The s?statdocks create command will give you a menu of more preset counters you can create. You can create them with s?statdock create preset_name replacing "preset_name" with the counter from the previous menu you want. This is case-sensitive!

Finally, you can create a Statdock with a custom name and 1 counter with the s?statdocks create custom command. Running this without any text after it will give you a different menu with even more counters with number next to them. Take note of the the number next to the counter you want to insert. Putting that number between {{ }}, put your custom text after the command.

Example: s?statdocks create custom There are {{19}} users with 9 humans with create a channel with the name There are 9 users.

Website Configurator

The Website Configurator unlocks the full power of Statdocks and all the customization available to you. It is the only way to create some counters and change the settings of others.

Navigation

After going to the Manage page of your server, you'll find "Statdocks" on the sidebar menu. On the Statdocks menu, you’ll be greeted with a screen similar to the screenshot below.


Click + Add to create a new Statdock. You'll see the menu below whenever you add or edit a Statdock.

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 Statdocks counters. You may want to use less frequent updates to reduce audit log spam. 6 Minute updates are restricted to servers with the Statdocks+ upgrade.

Saving

When you save a new Statdock, the bot will attempt to make the Discord channel.

If it fails, it will let you know what’s wrong. You will also have a chance to save the configuration so that you don't lose your hard work while you fix the problem.

If it succeeds, the bot 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.

Counters

Free Counters

  • 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 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.
Important

Countdown / Timer is for time and not the same as Countdown From / Goal which is explained below.

Premium Counters

These counters require the Statdocks+ premium upgrade. The fastest Check Frequency you can set on them is 1 Hour (although you can update them on-demand with the statdocks update command).

statdocks-average-counter

  • 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.

Countdown From / Goal

Countdown From / Goal is a special option that all non-time counters have. Leaving this field blank will show the count from the counter. Filling in a value will subtract the count from that value.

Example: If the server has 8 users and set Countdown From / Goal to 10, the number shown on the Statdock will be 2. This allows you to have value-based countdowns to milestones like member count!

(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 from old Statdocks. Deleting a Statdock’s Discord channel will automatically deactivate the Statdock.

Statdocks+ (Premium Upgrade)

The Statdocks+ premium upgrade unlocks the 6 premium counter types explained above.

FAQ

How often do Statdocks update?

Statdocks created through the bot update every 10 minutes. You can set this when creating and editing Statdocks on the website.

Can I make Statdocks not voice channels?

Not currently, though it is planned to allow the designation of text channels and messages instead of voice channels.

How do I get the lock icon?

Administrators can join all voice channels therefore they appear as speakers with a small lock. Anybody who cannot join the channel will see it as a large lock.

How do I delete a Statdock?

The easiest way is to delete the Discord channel. However, the configuration will remain on your server's Manage page and will continue to count towards the server's 50 Statdock limit.

Can I move my Statdocks such as to other categories?

Yes! Just be mindful of the permission. Statbot requires See Channel, Manage Channel, and Connect to edit the channel name. It adds itself as a user overwrite to the channel so the Statdock will be fine if you don't change / sync its permissions to a category.

Can Statdocks update any faster than every 10 minutes / 6 minutes?

No. Discord rate limits prevent bots from editing channel names any faster than twice every 10 minutes.

Can I manually update a Statdock?

Yes, you can with the statdocks update. Note that this command cannot ignore the rate limit above.

How do I add emojis to my Statdocks?

Where can I see what features are planned?

Development Trello Board