A powerful, multipurpose Discord bot built using discord.py. Packed with moderation tools, self-role support, XP system, anonymous systems, and utility commands — all controlled with a simple prefix.
- ⚒️ Moderation: Ban, Kick, Mute, Warn, Unwarn
- 📊 XP System: Add XP, Reset XP, Leaderboard support
- 📢 Instagram Notification System
- 🔧 Utility Commands: Ping, About Owner, Rules
- 📚 Self Roles & Role Embeds
- 💬 Fully customizable and easy to expand
- 📩 Ban appeal system with tickets & transcripts
- 🎉 Booster detection
- 🛡️ Custom auto mod with link filtering and role restrictions
- 🧠 Interactive status system with livestream, video, DND, and more
- Private Vc Functioning
Follow these steps to run the bot on your own machine:
git clone https://github.com/SwastikKaushal1/Custom-Discord-Bot.git
cd Custom-Discord-BotMake sure you have Python installed (3.10+ recommended).
Install dependencies:
pip install -r requirements.txtOpen the bot file (e.g., MAIN_BOT.py) and scroll to the config section.
You MUST fill out all the following variables with values from your server:
GUILD_ID = 123456789 # Main Server ID
APPEAL_SERVER_ID = 123456789 # Appeal Server ID
ADMIN_LOG_CHANNEL_ID = 123456789 # Admin Logs Channel
TRANSCRIPT_CHANNEL_ID = 123456789 # Ban Ticket Transcript Channel
APPEAL_CATEGORY_ID = 123456789 # Ticket category (Appeal Server)
MAIN_TICKET_CATEGORY_ID = 123456789 # Ticket category (Main Server)
APPEAL_SERVER_INVITE = "https://discord.gg/your-invite"
MAINSERVER = "https://discord.gg/main-server"
# ⚙️ Role & Channel IDs
IGNORED_ROLES = {role_id1, role_id2} # Roles ignored by auto mod
BLOCKED_LINK_CHANNELS = {channel_id1, channel_id2} # Link-blocked channels
MODERATOR_ROLES = {mod_role1, mod_role2} # Moderator role IDs
INSTA_NOTI_CHANNEL_ID = 123456789 # Instagram notifications
BOOST_CHANNEL_ID = 123456789 # Boost shoutout channel
BOOSTER_ROLE_ID = 123456789 # Booster role ID
NO_XP_ROLE_ID = 123456789 # Role that disables XP gain
BOT_COMMAND_ID = 123456789 # Level-up message channel
setup_channel_id = 123456789 # Appeal setup channel (buttons)
welcome_channel = 123456789 # Welcome channel ID
SERVER_NAME = "Your Server Name"
REACTION_CHANNEL_ID = 123456789 # Roles channel ID
# 🏷️ Required Roles
Banned_role = 123456789 # Role given to banned users
Appeal_role = 123456789 # Role given while appealing
💡 Tip: Use Developer Mode in Discord to get IDs.
This bot uses custom emojis for embed messages and self-role reactions.
⚠️ You must upload the emojis to your own server and use the correct format to reference them in your config or code.
Use the following formats:
<:emoji_name:emoji_id> # For static emojis
<a:emoji_name:emoji_id> # For animated emojis
Run the bot using:
python MAIN_BOT.pyMake sure your bot is invited to both the main server and appeal server with necessary permissions (manage roles, manage channels, read message history, etc.).
| Command | Description |
|---|---|
?helpadmin |
👑 Shows all admin commands |
?helpmod |
🛠️ Shows all moderator commands |
Sometimes, when the bot interacts with a channel (e.g., issuing warnings, managing tickets), Discord may delete the channel. However, there can be a slight delay before the bot recognizes that the channel is deleted. During this lag, the bot might attempt to interact with the deleted channel, causing an error.
Note: This is a temporary issue due to the lag between Discord deleting the channel and the bot detecting the change. The bot will automatically ignore these errors and continue functioning normally without crashing.
- Make sure all role and channel IDs exist on your server.
- Don’t forget to create the
bannedandappeal is openroles. - You must invite the bot with message content intent enabled.
- Ban appeal tickets are handled in the appeal server via buttons.
For support, email swastik2022008@gmail.com or join our Discord Channel If you want help with hosting (Paid hosting) i can help you set it up or making a custom discord bot will be there to help you
Made with ❤️ by SwastikKaushal
