Guest

Guest User

Sign in to access features

Custom Branding Setup

Create your own Discord bot and personalize VulcanBot's appearance with your branding. Follow this step-by-step guide to set up your custom bot.

⚠️ Critical Requirements

Your custom bot must have Administrator permissions on your server and all three Gateway Intents must be enabled in the Discord Developer Portal. Without these settings, your custom bot will not function correctly.

1

Create a Discord Application

Set up your bot in the Discord Developer Portal

Go to Discord Developer Portal

Open your browser and navigate to the Discord Developer Portal:

Open Discord Developer Portal

Log in with your Discord account if prompted.

Create New Application

  1. Click the "New Application" button in the top right corner
  2. Enter a name for your bot (e.g., your server name or custom bot name)
  3. Accept the Discord Developer Terms of Service
  4. Click "Create"

Tip: Choose a memorable name that represents your community. This will be displayed as your bot's username in Discord.

2

Configure Your Bot

Set up the bot settings and enable required permissions

Navigate to the Bot Section

  1. In the left sidebar, click on "Bot"
  2. Click the "Add Bot" button if prompted
  3. Confirm by clicking "Yes, do it!"

Customize Your Bot's Appearance

  1. Click on the bot's avatar to upload your custom icon/logo
  2. Optionally change the Username
  3. Add a custom Banner if desired

Tip: Use a square image (at least 128x128 pixels) for the best avatar quality.

CRITICAL: Enable ALL Gateway Intents

Scroll down to the "Privileged Gateway Intents" section and enable ALL THREE intents:

PRESENCE INTENT

Required for user presence and status tracking

SERVER MEMBERS INTENT

Required for member management and moderation

MESSAGE CONTENT INTENT

Required for auto-moderation and message logging

Warning: If any of these intents are disabled, your custom bot will NOT function correctly. Auto-moderation, message logging, and member tracking features will fail.

3

Get Your Bot Token

Copy the secret token to connect your bot

Reset and Copy Token

  1. In the Bot section, find the "Token" area
  2. Click "Reset Token"
  3. Confirm by clicking "Yes, do it!"
  4. Click "Copy" to copy your new token

Security Warning: Never share your bot token with anyone! Treat it like a password. Anyone with your token can control your bot.

Important: You can only see the token once after resetting. Make sure to copy it before closing the page!

4

Invite Bot to Your Server

Generate an invite link and add the bot

Generate Invite Link

  1. In the left sidebar, click on "OAuth2" → "URL Generator"
  2. Under SCOPES, check:
    • bot
    • applications.commands
  3. Under BOT PERMISSIONS, check Administrator

CRITICAL: Required Permissions

Your custom bot MUST have all required permissions to function correctly. VulcanBot needs access to:

  • Manage channels (for tickets, voice management, stat channels)
  • Manage roles (for mutes, auto-mod actions)
  • Ban/Kick members (for moderation)
  • Manage messages (for auto-mod, logging)
  • View all channels (for monitoring and logging)
  • Or Administrator, with the correct role hierarchy

Complete the Invite

  1. Scroll down and copy the Generated URL
  2. Open the URL in your browser
  3. Select your server from the dropdown
  4. Click "Authorize"
  5. Complete the captcha if prompted

Success: Your custom bot should now appear in your server's member list (it will show as offline until connected).

5

Configure in VulcanBot Dashboard

Connect your custom bot to VulcanBot

Open Custom Branding Settings

  1. Log in to the VulcanBot Dashboard
  2. Select your server
  3. Navigate to "Custom Branding" in the sidebar

Enter Your Bot Token

  1. Paste your bot token in the token field
  2. Click "Save Token"
  3. Wait for the bot to connect (may take a few seconds)

Security: Your token is encrypted and stored securely. Only you can access it, and it's never logged or shared.

Customize Branding Options

Once connected, you can customize various branding options:

Custom Colors

Change embed accent colors to match your brand

Custom Footer

Personalize the footer text on bot messages

Custom Images

Add your logos and thumbnails to embeds

Bot Identity

Your bot appears with your custom name and avatar

Troubleshooting

Common issues and how to fix them

Bot won't come online?

  • Verify the token is correct (no extra spaces)
  • Ensure all three Gateway Intents are enabled
  • Check if the bot was properly invited with the correct permissions
  • Try resetting the token and entering it again

Commands not working?

  • Ensure applications.commands scope was selected during invite
  • Verify bot has Administrator permission in your server
  • Commands may take up to an hour to sync after first setup

Missing message content or members?

  • The MESSAGE CONTENT INTENT must be enabled
  • The SERVER MEMBERS INTENT must be enabled
  • After enabling intents, you may need to reconnect the bot

Need more help?

Join our Discord support server for assistance:

Join Support Server

🎉 You're All Set!

Your custom branded bot is now ready to use. All VulcanBot features will work through your personalized bot identity.

✅
Admin Perms
Required
✅
All Intents
Enabled
✅
Token Set
Configured
Go to Dashboard