Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cdc-bot/main/llms.txt

Use this file to discover all available pages before exploring further.

CDC Bot is a Python-based Discord bot. To use it in your server, a bot administrator must host it and invite it using a Discord bot token. This page walks through what happens when the bot starts up and how to verify it is working in your server.
CDC Bot requires a Discord bot token stored in the CDC_TOKEN environment variable to run. Contact your bot administrator if you need access.

How CDC Bot starts

When CDC Bot launches, it:
  1. Connects to Discord using the CDC_TOKEN environment variable
  2. Loads four extension modules: preferences, currency, marriages, and server_preferences
  3. Begins rotating its custom status every 5 minutes
  4. Registers all slash commands with Discord
1

Invite the bot to your server

Ask your bot administrator to generate an invite link with the following permissions:
  • Read Messages / View Channels
  • Send Messages
  • Add Reactions
  • Manage Messages (required for word games to delete incorrect messages)
  • Read Message History
The bot requires the applications.commands scope to register slash commands.
2

Verify the bot is online

Once invited, CDC Bot should appear online in your member list. Its status will rotate between custom messages every 5 minutes.
3

Try your first command

Type /opinion in any channel the bot can see. The bot will respond with a random opinion about you, confirming it is working correctly.

Debug mode

CDC Bot supports a debug mode for development. When the CDC_DEBUG environment variable is set to 1, the bot:
  • Restricts slash command registration to a specific test guild
  • Enables verbose logging at the DEBUG level
This mode is only relevant if you are running or developing the bot yourself.

Next steps

Configuration

Configure per-server and per-user preferences

Features overview

Explore what CDC Bot can do

Build docs developers (and LLMs) love