Discord Token Setup Guide

To set up a Discord bot token for VibeCord, create a bot application in the Discord Developer Portal, copy the Bot Token, then paste it into your VibeCord project.

Last updated: 2025-12-14

This only needs to be done once — after setup, VibeCord handles everything else.

Time Required

This setup takes about 2-3 minutes to complete.

---

Why You Need a Bot Token

Your Discord bot token is like a password that lets your bot connect to Discord’s servers. Without it, your bot can’t:

• Receive messages and commands from users
• Send responses back to Discord
• Manage roles, channels, or other server features

Keep It Secret!

Never share your bot token with anyone. If your token is leaked, someone could take control of your bot. Regenerate it immediately if compromised.

---

Step 1: Create a Discord Application

1. Open the Discord Developer Portal

   Go to discord.com/developers/applications and sign in with your Discord account.

2. Click “New Application”

   You’ll see a blue button in the top-right corner.

3. Enter your bot’s name

   Choose a name for your application (you can change this later). This will also be your bot’s default username.

4. Accept the Terms of Service and click “Create”

📷 Click to see: Creating the application

---

Step 2: Configure Bot Settings

1. Navigate to the “Bot” tab

   In the left sidebar, click on Bot.

2. Click “Add Bot” (if needed)

   If you don’t see a bot section yet, click Add Bot → Yes, do it!

3. Enable Privileged Gateway Intents

   Scroll down to the Privileged Gateway Intents section and enable these toggles:

   • ✅ Presence Intent — Lets your bot see member online/offline status
   • ✅ Server Members Intent — Lets your bot see member joins/leaves
   • ✅ Message Content Intent — Lets your bot read message text

4. Click “Save Changes”

   Don’t forget this step!

📷 Click to see: All intents enabled

Which intents do I need?

Intent	Use Case
Presence	Show when users are online, track activity
Server Members	Welcome messages, role assignment on join
Message Content	Read text messages (not just slash commands)

If unsure, enable all three — you can disable them later if not needed.

---

Step 3: Copy Your Bot Token

This is the most important step — you’ll need to copy this token and paste it into VibeCord.

1. Stay in the “Bot” tab

   You should still be on the Bot settings page.

2. Find the TOKEN section

   Scroll up to find the Token section (below the username and icon).

3. Click “Reset Token” or “Copy”

   • If this is a new bot, you may see Copy directly
   • If not, click Reset Token to generate a new one

4. Enter 2FA code if prompted

   Discord may ask for your authenticator code for security.

5. Copy the token immediately!

   Discord only shows the token once. Copy it right away and paste it into VibeCord.

📷 Click to see: Before revealing the token

Token Format

Your token should look something like this:

MTMxNTY4MDI0NTQ1MDQ.G4ABCD.xyz123abc456def789...

Token Security Warning

• Never paste your token in public chats, GitHub, or forums
• Never share screenshots showing your token
• If leaked, immediately click Reset Token to invalidate the old one

---

Step 4: Enter Token in VibeCord

Now paste your token into VibeCord:

1. Open your project in VibeCord

2. Click “Deploy” or open Settings → Discord Configuration

3. Paste your token in the Token field

4. Click “Save & Continue”

In-App Token Wizard

VibeCord includes a built-in wizard that guides you through these same steps:

Step 1 of the wizard:

Step 2 - Configure intents:

Step 3 - Paste your token:

Success!

---

Role Hierarchy (Important for Moderation Bots)

If your bot manages roles, you need to position the bot’s role correctly in your Discord server:

Bot Role Position

The bot can only manage roles below its own role in the hierarchy. If the bot role is at the bottom, it won’t be able to assign any roles!

How to fix:

1. Go to your Discord server settings → Roles
2. Find your bot’s role
3. Drag it above any roles the bot needs to manage

---

Quick Reference Card

Token Location

Discord Developer Portal → Your App → Bot → Token

Required Intents

Enable: Presence, Server Members, Message Content

Token Format

MTMx...ABC.XYZ.def... or mfa.xxxxx...

Security

Never share. Reset immediately if exposed.

---

Troubleshooting

”Invalid Token” Error

Possible causes:

• The token was copied incorrectly (missing characters)
• The token was reset in Discord Developer Portal
• You copied the Client Secret instead of the Bot Token

Solution: Go back to Discord Developer Portal → Bot → Reset Token → Copy again

Bot Shows as Offline

Possible causes:

• Token is incorrect or was reset
• Required intents not enabled
• Bot hasn’t been deployed yet

Solution: Verify intents are enabled, check token is correct, deploy the bot

Commands Don’t Appear

Possible causes:

• Slash commands can take up to 1 hour to sync globally
• applications.commands scope wasn’t included in invite

Solution: Wait 1 hour, or test in DMs with the bot first (syncs faster)

“Missing Permissions” Errors

Possible causes:

• Bot role is too low in the hierarchy
• Bot wasn’t invited with required permissions

Solution: Move bot role higher, or re-invite with correct permissions

---

Next Steps

Add Bot to Server

Add your bot to a Discord server →

Deploy Your Bot

Learn about deployment options →

References

• Discord Developer Portal
• Discord Developer Docs