Quick Setup

Get DCI Counting running in your server in a few steps.

How Counting Works

The core rules that govern every count.

Basic Rules

On a wrong count

When someone sends the wrong number: the message gets a ❌ reaction, the bot replies naming who ruined it and what score was reached, and the current count, streak, and saves all reset to 0.

Global tracking

Every correct count contributes to two global leaderboards — one ranked by highest count reached per server, and one ranked by total counts submitted per user. Both update in real time and are visible via /leaderboard and the public API.

General Commands

Available to all server members.

Admin Commands

Require Manage Server or Manage Channels permission.

Owner Commands

Restricted to bot owner IDs hardcoded in the source.

Slash Commands

Prefix Commands (!)

Gamemodes

Premium servers can activate special counting modes that change the rules.

Enabling a Gamemode

Anti-Cheat

AC v2 silently detects and blocks automated counting without disrupting legitimate users.

Checks

Flags and ignoring

Each violation writes a timestamped entry to the user's flag log with the guild ID and reason. After 5 session flags (default), the user is silently ignored — their messages are deleted with no feedback. Check logs with /integrity [userId].

Managing flags

Streaks & Goals

Track momentum and set targets to work towards.

Streaks

The streak increments on every correct count and resets on any mistake. Best streak is stored separately and never resets.

Goals

Set a target with /setgoal [number]. When reached, the bot sends a celebration embed and clears the goal. Use /setgoal 0 to clear manually.

Leaderboards

Two global leaderboards — one for servers, one for users.

Server leaderboard

Servers ranked by highest count ever reached. This score never decreases. The current server is marked with ◄.

User leaderboard

Users ranked by total correct counts submitted across all servers. Lifetime cumulative. Tags appear next to names.

Commands

/leaderboard                   — defaults to server leaderboard
/leaderboard type:Servers      — top 10 servers by highest count
/leaderboard type:Users        — top 10 users by total counts

The footer shows your rank and score even if outside the top 10. Also accessible via GET /api/v1/leaderboard.

Premium

Unlock the full feature set of DCI Counting for your server.

Guild Portal

A web dashboard for server admins to manage all settings without touching Discord.

Available settings

Public API

Access DCI Counting data programmatically.

Base URL

https://panel.dcicounting.com/api/v1

Authentication

# Via header (recommended)
X-API-Key: dci_your_key_here

# Via query param

GET /api/v1/bot?api_key=dci_your_key_here

Rate limits

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1713456789

Error codes

API Endpoints

Full reference for all endpoints.

Free Endpoints

{ "name": "DCI Counting", "id": "...", "version": "v3.0",
  "guilds": 42, "totalCounts": 158392, "totalUsers": 891,
  "flaggedUsers": 7, "ping": 43,
  "uptime": { "seconds": 86400, "human": "24h 0m 0s" } }

{ "servers": [{ "rank": 1, "guildId": "...", "name": "The Bread Club", "score": 4521 }],
  "users":   [{ "rank": 1, "userId": "...", "totalCounts": 2891, "bestStreak": 450 }],
  "limit": 10, "generatedAt": "2026-04-18T15:00:00.000Z" }

{ "guildId": "...", "name": "The Bread Club", "memberCount": 312,
  "currentCount": 3891, "streak": 142, "bestStreak": 450,
  "isPremium": true, "tags": ["Premium"], "goal": 5000,
  "globalRank": 1, "description": "We count bread." }

Premium Endpoints

{ "userId": "...", "username": "carter", "totalCounts": 2891,
  "bestStreak": 450, "tags": ["Staff"], "flagged": false, "flagCount": 0 }

// Request body
{ "message": "Optional plain text",
  "embed": { "title": "Title", "description": "Body", "color": "#38bdf8", "footer": "Footer" } }

// Response
{ “ok”: true, “guildId”: “…”, “channelId”: “…” }

API Keys

How to generate and manage your API key.

Key format

dci_a3f8c2e1b9d47f6a2c8e1b3d7f9a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6

Programmatic generation

POST /api/v1/keys/generate
Content-Type: application/json
{ "guildId": "your_guild_id" }

// Response
{ “ok”: true, “apiKey”: “dci_…”, “issued”: “2026-04-18T15:00:00.000Z”,
“tier”: “premium”, “limits”: { “requestsPerMinute”: 120 },
“warning”: “Store this key securely. It will not be shown again.” }

Revoking

In the portal under API Access, click Revoke. Apps using the old key will immediately receive 401 errors.