Configuration

Doubt uses two configuration files and environment variables. Both configuration files are .gitignored for security.

Environment Variables (`.env`)

Copy .env.example to .env and fill in the values.

Required Variables

Variable	Description	Used When
`PRODUCTION`	Set to `true` for production, `false` for development	Always — controls which token/ID/URI set is used
`DEV_TOKEN`	Discord bot token for development	`PRODUCTION=false`
`DEV_CLIENT_ID`	Discord application ID for development	`PRODUCTION=false`
`DEV_GUILD_ID`	Guild ID for slash command registration	Always
`DEV_MONGODB_URI`	MongoDB connection string for development	`PRODUCTION=false`

Production Variables

Variable	Description
`CLIENT_TOKEN`	Discord bot token for production
`CLIENT_ID`	Discord application ID for production
`GUILD_ID`	Support/production guild ID
`MONGODB_URI`	MongoDB connection string for production

Optional Variables

Variable	Description
`DATABASE_URL`	MongoDB URI for Prisma CLI tools (`prisma db push`, etc.). Not used at runtime.
`TOPGG_TOKEN`	Top.gg API token for automatic stat posting

Production Toggle Behavior

The PRODUCTION flag controls which set of credentials the bot uses:

PRODUCTION=false  →  DEV_TOKEN, DEV_CLIENT_ID, DEV_MONGODB_URI
PRODUCTION=true   →  CLIENT_TOKEN, CLIENT_ID, MONGODB_URI

The guild ID for command registration:

PRODUCTION=false  →  DEV_GUILD_ID
PRODUCTION=true   →  GUILD_ID

Environment variables are strings. Token, client ID, and guild ID selection compare against "true", but MongoDB URI selection uses process.env.PRODUCTION truthiness. With PRODUCTION=false as a string, config.handler.mongodb.uri may still select MONGODB_URI. Verify the generated src/config.js values before running a bot. See the Engineering Guide for details.

Runtime Configuration (`src/config.js`)

Copy src/example.config.js to src/config.js and customize.

Structure

module.exports = {
  client: {
    token: "...",   // Auto-selected based on PRODUCTION
    id: "...",      // Auto-selected based on PRODUCTION
  },
  variables: {
    channels: {
      logs: "",          // Channel ID for error logging
      botGuilds: "",     // Voice channel renamed to show guild count
      botUsers: "",      // Voice channel renamed to show user count
    },
    dbName: "...",       // "production" or "development" (auto-set)
    supportServerId: "", // GUILD_ID value
  },
  moderation: {
    developers: [""],    // Array of user IDs with developer access
    staffRoles: [""],    // Array of role IDs for staff commands
  },
  handler: {
    prefix: "?",         // Default prefix for prefix commands
    deploy: true,        // (unused by current code)
    guildDeploy: true,   // (unused by current code)
    guildId: "",         // Guild for developer command deployment
    commands: {
      prefix: false,     // Enable/disable prefix commands
      slash: true,       // Enable/disable slash commands
      user: true,        // Enable/disable user context menus
      message: true,     // Enable/disable message context menus
    },
    mongodb: {
      uri: "",           // Auto-selected MongoDB URI
      toggle: true,      // Enable/disable database connection
    },
  },
};

Key Configuration Notes

`moderation.developers`

Array of Discord user ID strings. Users listed here can use developer-only commands (/eval, /deploy, /badge, etc.). If this array is empty or missing, all developer commands are blocked with a configuration error message. See Security for eval sandbox rules and developer command gates.

`moderation.staffRoles`

Array of Discord role ID strings. Members with any of these roles can use staff-only commands.

`handler.commands.prefix`

Set to true to enable prefix commands (?help, ?ping, etc.). Disabled by default.

`handler.mongodb.toggle`

Set to false to skip the database connection entirely. The bot will start but all database-dependent features (economy, AFK, tickets, etc.) will fail.

`variables.channels.botGuilds` / `botUsers`

The bot renames these channels every 30 minutes to display current guild and user counts. If these IDs are empty or invalid, the bot will log non-fatal errors periodically. Set to valid voice channel IDs in your support guild, or leave empty and ignore the errors.

Per-Guild Prefix

Each guild can set a custom prefix with ?prefix set <new_prefix>. Custom prefixes are stored in the guildschemas MongoDB collection. If no custom prefix is set, the default from handler.prefix is used.

Get Started

Guides

Reference

Environment Variables (`.env`)

Required Variables

Production Variables

Optional Variables

Production Toggle Behavior

Runtime Configuration (`src/config.js`)

Structure

Key Configuration Notes

`moderation.developers`

`moderation.staffRoles`

`handler.commands.prefix`

`handler.mongodb.toggle`

`variables.channels.botGuilds` / `botUsers`

Per-Guild Prefix

​Environment Variables (.env)

​Required Variables

​Production Variables

​Optional Variables

​Production Toggle Behavior

​Runtime Configuration (src/config.js)

​Structure

​Key Configuration Notes

​moderation.developers

​moderation.staffRoles

​handler.commands.prefix

​handler.mongodb.toggle

​variables.channels.botGuilds / botUsers

​Per-Guild Prefix

Environment Variables (`.env`)

Required Variables

Production Variables

Optional Variables

Production Toggle Behavior

Runtime Configuration (`src/config.js`)

Structure

Key Configuration Notes

`moderation.developers`

`moderation.staffRoles`

`handler.commands.prefix`

`handler.mongodb.toggle`

`variables.channels.botGuilds` / `botUsers`

Per-Guild Prefix