Core Features

Counters

Dynamic channels that automatically update their names to display real-time server statistics. Track members, bots, boosts, roles, and more with customizable formatting and goal celebrations.

Counters update every 15 minutes and work with voice, text, stage, and category channels.

Table of Contents


Quick Start

Create Your First Counter

# Basic member counter (voice channel recommended)
/counter create type:Members & Bots channel:Voice (Recommended)

# Custom formatted counter
/counter create type:Server Boosts channel:Voice template:🎉 Boosts: {count}

1. Choose Counter Type

Select what you want to track (members, bots, boosts, roles, etc.)

2. Select Channel Type

Voice channels recommended—they're visible but non-interactive

3. Set Template (Optional)

Customize display format using {count} placeholder


Counter Types

Member Tracking

Members & Bots

Total server population including bots

Default: All Members: 150

Members Only

Human members excluding bots

Default: Inhabitants: 142

Bots Only

Bot count in server

Default: Bots: 8

Members Without Roles

Users with only @everyone role

Default: No Roles: 12

Status Tracking

Online Members

Currently online (not offline/invisible)

Default: Online: 85

Offline Members

Offline or invisible users

Default: Offline: 57

Role-Based Counters

Requires Role: These counter types need the additional parameter with a role mention or ID.

Members With Role

/counter create type:Members With Role 
  additional:@RoleName

Counts users with specific role

Online With Role

/counter create type:Online With Role 
  additional:@Moderators

Online users with specific role

Offline With Role

/counter create type:Offline With Role 
  additional:@Staff

Offline users with specific role

Server Statistics

Server Boosts

Current boost count

Default: Boosts: 14

Roles in Server

Total role count

Default: Roles: 42

Banned Members

Total ban count

Default: Banned: 5

Requires bot's Ban Members permission

Pending Members

Members awaiting verification

Default: Pending: 3


Management

Basic Commands

/counter create type:Members Only channel:Voice (Recommended) template:👥 Members: {count} category:@Statistics
type
string required
Required - Specifies the counter type.
channel
channel required
Required - Channel to display the counter in.
template
string
Optional - Custom format for the counter display.
additional
role
Optional - Role used for role-based counters.
category
channel
Optional - Category to place the counter channel in.

Manual Refresh

Force immediate counter updates:

/counter refresh
Rate Limits Apply:
  • 10-minute cooldown per server
  • Counters updated recently are automatically skipped

Goals & Celebrations

Set milestones that trigger celebration messages when reached.

Creating Goals

/counter goal type:Members Only target:500 message:🎉 We hit {goal} members! Welcome {server} community! channel:#announcements display:Separate Channel

Display Modes

Inline Mode

Shows progress in existing counter

Members: 450/500

Goal removed from counter after reached

Separate Channel (Recommended)

Creates dedicated goal tracking channel

🎯 Goal: Members Only: 450/500

Auto-created if no channel specified

Message Placeholders

Use these in your celebration message:

PlaceholderReplaced WithExample
{count}Current count502
{goal}Target number500
{server}Server nameMy Server
{type}Counter typeMembers Only

Goal Management

/counter goal-status

Shows:

  • Current progress
  • Progress bar
  • Remaining count
  • Celebration channel
  • Display mode
Only one active goal per server. Goals support: Members & Bots, Members Only, Bots Only, Server Boosts.

Customization

Templates

Use {count} as placeholder for the number:

# Default formatting
Members: 150

# With emoji
👥 Members: 150

# With decoration
╭─ Members: 150 ─╮
Template Tips:
  • Keep under 100 characters
  • Use clear, readable text
  • Avoid special characters (auto-filtered)
  • {count} is replaced automatically

Channel Types

TypeBest ForNotes
VoiceGeneral statsRecommended visible but non-interactive
TextDetailed infoCan send messages
StagePremium serversLevel 3 boost required
CategoryOrganizationActs as folder
AnnouncementNews-styleCan be followed

Permissions

Required Permissions

Manage Channels

User: Needed to create, edit, and delete counters

Bot: Requires these permissions in the category/server:

  • Manage Channels - Update channel names
  • View Channel - Read channel info
  • Send Messages - For text channels
  • Connect - For voice channels
If bot lacks Manage Channels in a category, counters in that category will fail to update.

Special Requirements

Counter TypeAdditional Permission
Banned MembersBot needs Ban Members
All OthersStandard permissions only

Troubleshooting

Common Issues


Best Practices

Server Organization

Use Categories

Create a "📊 Statistics" category to group all counters together

Consistent Naming

Use matching emoji/formatting across all counters for visual cohesion

Permission Setup

Lock counters to prevent users from joining/messaging

Performance Tips

  • Avoid role-based counters on 1000+ member servers (slow member iteration)
  • Use voice channels for best performance and visibility
  • Limit to 3-4 counters per server for optimal update speed
  • Don't manually edit counter channels (bot will revert changes)

Goal Strategy

Effective Goals:
  • Set realistic targets (20-30% above current)
  • Use engaging celebration messages with placeholders
  • Choose high-traffic channels for announcements
  • Separate display mode for prominent tracking

FAQ


Need help with counters? Join our support server or check the FAQ.