Back to Documentation

How to Use Counting Bot - Discord Counting Game

Complete guide on how to use Counting Bot to set up counting channels, track statistics, view leaderboards, and compete with other users in your Discord server.

Who it's for: Discord server administrators and members who want to add a fun counting game with statistics, leaderboards, and achievements to their server.

Outcome: You will know how to set up counting channels, count numbers, view your statistics, check leaderboards, see achievements, and manage counting channels.

Prerequisites

  • Discord server with admin permissions (for setup)
  • Counting Bot already added to your server
  • Bot has required permissions (View Channels, Send Messages, Read Message History, Add Reactions)

Installation

  1. 1

    Set up a counting channel

    Register a text channel as a counting channel. You need "Manage Server" permission to set up channels. The channel will start at 0, and the next number to count will be 1. You can set up multiple counting channels in your server.

    /count setup channel:#counting
  2. 2

    Start counting

    Once a channel is set up, users can start counting! Simply type numbers in sequence: `1`, then `2`, then `3`, and so on. The bot will react with ✅ when you count correctly. Rules: You cannot count twice in a row (same user), only pure numbers are accepted (like "123", not "123abc"), and if someone counts the wrong number, it resets to 1.

    1
    2
    3
    4
  3. 3

    View your statistics

    Check your personal counting statistics including total counts, fails, success rate, current streak, best streak, and best number achieved. You can also view other users' stats by mentioning them.

    /count stats
    /count stats user:@username
  4. 4

    View the leaderboard

    See rankings in your server or globally across all servers. You can rank by total counts or best number achieved. The leaderboard shows the top 10 users with medals (🥇🥈🥉).

    /count leaderboard
    /count leaderboard scope:global metric:best

Configuration

  1. 1

    List all counting channels

    View all counting channels in your server with their current counts. This helps you see which channels are active and what numbers they're at.

    /count list
  2. 2

    Get channel information

    View detailed information about a specific counting channel including current count, next number, highest value reached, and last counter. If no channel is specified, shows info for the channel where you run the command.

    /count info
    /count info channel:#counting
  3. 3

    View count history

    See recent counting activity for yourself or another user. Shows up to 20 entries with timestamps showing when each number was counted. Default shows 10 entries, but you can specify a limit.

    /count history
    /count history user:@username limit:20
  4. 4

    View server statistics

    Check server-wide statistics including total counting channels, active users, total counts across all channels, total fails, top user, and overall success rate. Great for seeing how active your counting community is.

    /count serverstats
  5. 5

    Reset a counting channel

    Reset a channel's count back to the start value (0, so next number is 1). Requires "Manage Server" permission. This clears the last counter and resets the current count. Useful if you want to start fresh or if counting gets stuck.

    /count reset channel:#counting
  6. 6

    Remove a counting channel

    Remove a channel from counting. Requires "Manage Server" permission. This deletes the channel's data from the bot. The channel will no longer track counts, but you can set it up again later if needed.

    /count remove channel:#counting
  7. 7

    Get help

    View help information and command reference. Shows a list of all available commands, quick start guide, and a link to detailed documentation.

    /count help

Verification

Test the complete workflow: set up a counting channel, count a few numbers, check your stats, view the leaderboard, and see channel info. You should see the bot react with ✅ on successful counts, your stats updating, and leaderboard rankings.

/count setup channel:#counting
1
2
3
/count stats
/count leaderboard
/count info

Expected output:

✅ Channel registered successfully!
✅ (reaction on your count)
📊 Your Statistics:
Total Counts: 3
Fails: 0
Success Rate: 100%
Current Streak: 3
Best Streak: 3
Best Number: 3

Common Errors & Quick Fixes

Bot not responding to counts

Fix: Check if the channel is registered using `/count list`. Verify the bot has permissions in the channel (View Channels, Send Messages, Read Message History, Add Reactions). Ensure the bot is online (green status). If the bot still doesn't respond, contact the server administrator or bot owner.

Commands not appearing

Fix: Wait a few minutes after bot startup for command registration (commands register globally). Restart Discord client. Check bot has "Use Application Commands" permission. Verify bot is online.

Same user error (cannot count twice in a row)

Fix: This is by design - the same user cannot count twice in a row to ensure fairness. Wait for another user to count before you count again. This rule cannot be disabled.

Wrong number error (count resets)

Fix: If someone counts the wrong number, the count resets to 1 (start value). This is the fail mode behavior and cannot be changed. Make sure you're counting the correct number - check `/count info` to see what number should be counted next.

Only numbers accepted (strict mode)

Fix: The bot only accepts pure numbers like "123". It will not accept "123abc" or "number 123". This is strict mode and cannot be disabled. Type only the number without any text.

Cannot set up channel (permission denied)

Fix: You need "Manage Server" permission to set up counting channels. Check your permissions in the server. Only server administrators can set up or remove counting channels.

Achievements or streak notifications not working

Fix: Ensure the bot has permission to send messages in the channel. Check the bot is not rate-limited. Verify the count was successful (bot reacted with ✅). Achievements trigger automatically at milestones (10, 25, 50, 100, 250, 500, 1000, etc.).

Leaderboard not updating

Fix: Global leaderboard updates every 5 minutes automatically. Server leaderboard updates in real-time. If you don't see yourself on the leaderboard, make sure you have counts recorded. Check `/count stats` to verify your counts are being tracked.

Important Notes

  • Set up multiple counting channels for different categories or difficulty levels
  • Check your statistics regularly to track your progress and streaks
  • Compete with others on the server or global leaderboard
  • Aim for achievement milestones (10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 25000, 50000, 100000)
  • Build your streak - every 10 streak milestones trigger notifications
  • View count history to see when you counted specific numbers
  • Remember: Same user cannot count twice in a row (fairness rule)
  • Remember: Wrong numbers reset the count to 1 (fail mode)
  • Remember: Only pure numbers accepted (strict mode, no text)
  • Use `/count help` to see all available commands and options
Tested on: Discord.js v14, Discord API v10, Counting Bot latest
Last updated: 1/23/2025