Settings

This page explains the settings file used by BB-DBotBits. It controls things like bot status text, ticket role access, rules setup, credits, and XP promotion.

Where does this file go?

A blank settings page goes into bb-dbotbits >> settings >> settings.js

Example usage 
const settings = require('./settings.js');

// Example:
console.log(settings.botStatusTxt);

Bot Status

These options control whether the bot shows a custom Discord status, and what it displays.

settings.js — Bot Status 
// Bot Status
const showStatus = true;

// Can be: 'online', 'idle', 'dnd', 'invisible'
let botOnlineStatus = 'online';

// The status message text
let botStatusTxt = 'Created using BB-DBotBits';

// 0 Playing, 1 Streaming, 2 Listening, 3 Watching, 4 blank, 5 Competing
let botDoing = 4;

What the values mean

  • showStatus — turns the status system on/off.
  • botOnlineStatus — controls the online indicator (online/idle/dnd/invisible).
  • botStatusTxt — the text users see under your bot name.
  • botDoing — the activity type (Playing / Listening etc).
Tip: If you want a clean bot with no activity line, use botDoing = 4 (blank) and keep your botStatusTxt short.

Ticket Access Roles

This controls which roles can see and manage tickets. Add as many role IDs as you want. Role IDs must be strings inside quotes.

settings.js — ticketAccess 
let ticketAccess = [
  '000000000000000000',
  // '000000000000000000',
  // '000000000000000000'
];
Important: Some role IDs begin with 0 — keep them inside quotes or JavaScript can break/strip them.

Rules Settings

The rules system needs two IDs: roleId = the role granted after accepting rules, and channelID = where the rules message is posted.

settings.js — rulesSettings 
let rulesSettings = [
  {
    roleId: '000000000000000000',
    channelID: '000000000000000000'
  }
];

If you run multiple servers or want different rule configs, you can expand this array with more objects.

Credits

This controls whether credits are shown. If you’re using BB-DBotBits for anything serious, keep credits on (or support the project via the donate link).

settings.js — showCredits 
const showCredits = true;

XP System

XP can optionally auto-promote users when they reach a certain level. If you already manage roles manually, keep promotion off.

settings.js — XP Promotion 
// XP System
promoteUserOnXP = false;      // enable/disable auto promotion
requiredPrmoteLevel = 5;      // level required
promotionRoleId = 'YOUR_ROLE_ID';

How it works

  • promoteUserOnXP — when true, the bot will promote users automatically.
  • requiredPrmoteLevel — the level they must reach.
  • promotionRoleId — the role to grant when promoted.
Common setup: Give new users a “Newbies” role, then auto-promote them to “Members” once they reach level 5.

Full export

This is the export line that makes your settings available to your bot:

settings.js — module.exports 
module.exports = {
  ticketAccess,
  rulesSettings,
  showCredits,
  botOnlineStatus,
  botStatusTxt,
  botDoing,
  showStatus,
  promoteUserOnXP,
  promotionRoleId,
  requiredPrmoteLevel
};

Next up: Rules