Documentation

🚀 Getting Started

Get DCMB Bot up and running in your Discord server in just a few minutes.

1

Step 1: Add the Bot

Click the button below to invite DCMB Bot to your Discord server. Make sure you have the "Manage Server" permission.

➕ Add to Discord

2

Configure Permissions

Grant the bot necessary permissions. We recommend Administrator for full functionality, or at minimum:

Manage Channels (for tickets)
Manage Roles (for custom roles)
Read/Send Messages
Add Reactions (for polls)
Embed Links

3

Set Up Ticket Category (Optional)

Create a category channel for tickets and note its ID. Configure it in the web dashboard or use the default.

💡 Tip: Enable Developer Mode in Discord settings to copy channel IDs.

4

Start Using Commands

Type /help in any channel to see all available commands. All commands use Discord's slash command system!

📝 Commands

Complete list of all available slash commands.

🎟️ Ticket System

/ticket

Opens a new support ticket. Creates a private channel where you can describe your issue.

Usage: /ticket

/close

Closes the current ticket channel. Only works inside ticket channels.

Usage: /close

/lock

Locks a ticket so members can't send messages. Staff can still view and respond.

Usage: /lock

/flag

Flags a ticket for staff review. Notifies staff role with your note.

Usage: /flag

/add

Adds another user to the ticket by their Discord ID.

Usage: /add

🎨 Custom Roles

/setrole

Create or join a role with a custom name and color.

Colors: red, blue, green, yellow, purple, orange, teal, magenta, grey, default

/removerole

Remove a role you currently have by entering its exact name.

Usage: /removerole

⭐ XP & Ranking

/rank

Check your current XP and level. Shows your progress in a beautiful embed.

Usage: /rank

📊 How XP Works: Earn 5-15 XP per message automatically. Level up every 100 XP (configurable).

📊 Polls & Community

/poll

Create an interactive poll with 2-9 options. Automatic emoji reactions for voting.

Usage: /poll
Enter your question and options (one per line)

🎙️ Private Voice Channels

🚀 Setup: Create a voice channel named "Create Private VC" (or similar). When users join it, they automatically get their own private voice channel!
👮 Staff Access: Members with Staff, Moderator, or Admin roles can see and join all private VCs with full control permissions.

/vc-invite

Invite a user to your private voice channel. They'll receive a DM notification.

Usage: /vc-invite @user

/vc-kick

Remove a user from your private voice channel and revoke their access.

Usage: /vc-kick @user

/vc-limit

Set the maximum number of users allowed in your VC (0 for unlimited, max 99).

Usage: /vc-limit 5

/vc-rename

Rename your private voice channel to anything you want (max 100 characters).

Usage: /vc-rename Gaming Room

/vc-lock

Lock your voice channel. No one can join unless you invite them.

Usage: /vc-lock

/vc-unlock

Unlock your voice channel. Returns to invite-only mode.

Usage: /vc-unlock

🗑️ Auto-Deletion: When everyone leaves your private VC, it's automatically deleted. No cleanup needed!

ℹ️ General

/help

Shows all available commands with brief descriptions.

Usage: /help

/ping

Check if the bot is online and see its response time.

Usage: /ping

⚙️ Setup Guide

Configure DCMB Bot for your server's specific needs.

Ticket System Setup

Create a new category channel (e.g., "Support Tickets")
Right-click the category → Copy ID (Developer Mode must be enabled)
Visit the web dashboard and paste the category ID
Create a staff role and set its ID in the dashboard
Staff will be notified when tickets are flagged

XP System Configuration

Setting	Default	Description
XP Min	5	Minimum XP per message
XP Max	15	Maximum XP per message
Level Scale	1.2	XP curve difficulty
Notify Every	100	XP between level-up notifications

Role Colors

Customize available role colors in the dashboard. Default colors:

Red

Blue

Green

Yellow

Purple

Orange

Teal

Magenta

Grey

🔐 Permissions

Understanding bot permissions and what they're used for.

Required Permissions

Manage Channels: Create and delete ticket channels
Manage Roles: Create custom member roles
Read/Send Messages: Respond to commands and send notifications
Add Reactions: Add emoji reactions to polls automatically
Embed Links: Display rich embeds for polls, ranks, and help
Manage Messages: Clean up old messages in tickets (optional)

⚠️ Important: The bot needs these permissions in the categories/channels where it operates. If a command fails, check channel permissions!

🌐 Web Dashboard

Manage your bot settings through our web interface.

Accessing the Dashboard

Visit dcmb.app
Click "Login with Discord"
Authorize the application
Select your server from the list

Dashboard Features

Configure ticket category and staff roles
Customize XP system settings
Manage available role colors
View bot status and statistics
Per-server configuration (each server is independent)

💡 Pro Tip: Changes in the dashboard take effect immediately—no bot restart required!

❓ Frequently Asked Questions

How do I enable Developer Mode to copy IDs?

In Discord: User Settings → Advanced → Enable "Developer Mode". Then right-click channels/roles to copy their IDs.

Can I use the bot on multiple servers?

Yes! Each server has independent configuration. Settings you change on one server don't affect others.

Why isn't the ticket command working?

Make sure you've set a ticket category ID in the dashboard and the bot has "Manage Channels" permission in that category.

Can I customize the XP gain amounts?

Yes! Use the web dashboard to adjust XP min/max per message and level scaling.

How do I add more role colors?

Visit the web dashboard and edit the color map in your server's settings. You can add custom hex colors.

Is my data safe?

Yes! We only store necessary data (XP, server configs) and never share it with third parties. See our Privacy Policy.

The bot is offline. What should I do?

Check our Discord server for status updates. Scheduled maintenance is announced in advance.

How can I get support?

Join our Discord server and create a ticket in the support channel. Our team responds within 24 hours!