Bee-Bota Documentation
Welcome to the official developer and administrator guide for Bee-Bota — the all-in-one Discord community suite featuring dedicated level-up channel routing, studio music streaming, automated moderation shields, Google Gemini AI, and a real-time web management panel.
Pro Tip: Bee-Bota supports native Discord Slash Commands (/) with autocomplete as well as traditional prefix commands (default prefix is !).
Quickstart: Adding Bee-Bota to your Server
1
Invite the Bot
Click Add to Discord and select your server from the dropdown. Ensure Administrator or required channel permissions are granted.
2
Check Online Status
Type /help or !help in any text channel to test responsiveness and browse active command categories.
3
Open the Web Dashboard
Visit /dashboard, click Login with Discord, and customize your server's settings with zero terminal commands.
Recommended Bot Permissions
Bee-Bota requires specific Discord permissions to execute commands smoothly across your server:
| Permission | Why It's Needed | Critical? |
|---|---|---|
Send Messages & Embeds |
Display rich responses, music player status, leveling cards, and warnings. | REQUIRED |
Connect & Speak |
Join voice channels to stream music, radio, and TTS audio. | REQUIRED |
Manage Messages |
Used by AutoMod to delete spam, phishing links, and execute /purge. |
RECOMMENDED |
Manage Roles |
Used to assign leveling milestone roles and apply mute roles. | RECOMMENDED |
Web Dashboard Setup
Every server administrator who invites Bee-Bota can configure their server directly through the browser:
- Role-Based Access: Community server admins can customize their server's leveling channel routing, AutoMod rules, and view server activity logs.
- Zero Installation: Cloud-hosted 24/7. Simply visit /dashboard and authenticate with your Discord account.
⭐ Advanced Leveling, Speed Customization & Role Rewards
Bee-Bota gives server administrators full control over leveling speeds, difficulty curves, voice channel XP, automated role rewards, and dedicated level-up announcements.
You can customize every setting either via Discord Slash Commands or through the real-time Web Control Panel.
⚡ Speed & Progression Customization Commands:
| Command | Description | Example |
|---|---|---|
| /levelspeed <rate> | Set server-wide XP multiplier (0.1x to 20x) for Double XP events or slow grinds. | /levelspeed rate:2.0 |
| /levelcurve <difficulty> | Adjust XP curve steepness (Fast 0.5x, Normal 1.0x, Hardcore 2.0x, Extreme 3.0x). | /levelcurve difficulty:0.75 |
| /voicexp <enabled> [min] [max] | Enable or disable periodic XP rewards for members in Voice Channels. | /voicexp enabled:True min_xp:15 max_xp:30 |
| /levelrange <min> <max> | Set min and max XP earned per chat message. | /levelrange min_xp:20 max_xp:40 |
| /levelcooldown <seconds> | Set chat cooldown in seconds between XP awards. | /levelcooldown seconds:45 |
| /addlevelrole <level> <@role> | Automatically assign a prestige role when reaching a level milestone. | /addlevelrole level:5 role:@Bronze |
| /removelevelrole <level> | Remove a configured milestone role reward. | /removelevelrole level:5 |
| /levelroles | List all active milestone role rewards for this server. | /levelroles |
| /levelignorechannel <channel> | Disable XP gains in a specific channel (e.g. #bot-spam). | /levelignorechannel channel:#spam |
| /setlevelchannel [channel] | Route level-ups to a dedicated channel (or reset to active chat). | /setlevelchannel channel:#level-ups |
| /setlevelstyle [banner_url] [footer] | Customize Creavite GIF banner animation and footer text. | /setlevelstyle footer:HAPPY GAMING 💚 |
| /levelsettings | View full configuration summary, speeds, curve stats, and leaderboard. | /levelsettings |
Web Dashboard Setup:
- Open Dashboard -> Select your Server.
- Navigate to the Leveling & XP tab.
- Adjust the Global XP Speed Multiplier slider and Progression Curve dropdown.
- Add milestone role rewards in the Milestone Role Rewards section.
- Click Save All Leveling Settings. Changes apply instantly to Discord!
🎵 Studio Music & Audio DSP Filters
Bee-Bota features a high-fidelity audio engine powered by FFmpeg with real-time digital signal processing (DSP) filters:
| Command | Description | Example |
|---|---|---|
| /play <query/url> | Search and play tracks from YouTube, Spotify, SoundCloud, or direct URLs. | /play Bohemian Rhapsody |
| /pause / /resume | Pause or resume the currently playing audio stream. | /pause |
| /skip | Vote or force skip to the next track in the server queue. | /skip |
| /queue | View upcoming tracks, duration, and estimated playback time. | /queue |
| /bassboost <level> | Apply hardware-grade low-end bass boost (None, Low, Medium, High, Extreme). | /bassboost High |
| /nightcore | Accelerate pitch and tempo for a classic anime nightcore sound profile. | /nightcore |
| /8d | Enable binaural 8D rotating audio panning filter. | /8d |
| /stop | Stop playback, clear the queue, and leave the voice channel. | /stop |
🛡️ AutoMod & Server Defense
Protect your Discord community against malicious raids, invite spam, unauthorized links, and abusive behavior:
- Anti-Spam Shield: Detects and mutes users sending rapid repeated messages or massive emoji walls.
- Anti-Invite Shield: Automatically intercepts and deletes unauthorized Discord invite links (
discord.gg/...). - Word Blacklist: Add prohibited terms that trigger instant message deletion and administrative warnings.
🧠 Google Gemini AI Intelligence
Bee-Bota connects to Google's cutting-edge Gemini models to deliver fast, knowledgeable chat responses directly in your channels:
EXAMPLE PROMPT
/ask prompt: Explain quantum computing in 2 simple sentences🎮 Quizzes & Virtual Economy
Engage your members with competitive multiplayer trivia and a server coin economy:
/quiz start: Launches interactive multiple-choice trivia with sound effects and XP rewards./daily: Claim free daily currency reward./work: Complete mini-jobs to earn coins./leaderboard: Display the highest XP and wealthiest members.
📋 Audit & Server Activity Logs
Bee-Bota provides complete real-time event tracking and moderation audit trails:
- Voice Channel Tracking: Live logs of member joins, leaves, moves between voice channels, and voice XP award cycles.
- Moderation Action Logs: Record kicks, bans, mutes, warnings, and purged messages with moderator accountability.
- Level Progression Audits: Track manual XP adjustments, milestone rewards unlocked, and server wipe events.
- Real-Time Stream: Review the active audit feed directly from your Web Dashboard.
📜 Slash Commands vs Prefix
Bee-Bota supports both modern Discord Slash Commands (/) and legacy Message Prefix commands (!).
Recommendation: Use Slash Commands whenever possible! They provide instant parameter autocomplete, type validation, dropdown options, and ephemeral feedback.
- Slash Commands (
/): Fully interactive with parameter validation and inline descriptions. Type/in any channel to explore available commands. - Prefix Commands (
!): Traditional text commands (e.g.,!help,!rank,!play song). Server administrators can customize the prefix in the dashboard. - Command Aliases: Many commands feature intuitive shorthand aliases (e.g.,
/rank➔/xp,/profile;/levels➔/leaderboard,/top).
🎵 Studio Music Command Reference
Complete control over voice audio playback, queue management, and real-time DSP audio filters:
| Command | Aliases | Description | Example |
|---|---|---|---|
| /play <query/url> | !play, !p |
Search and play tracks from YouTube, Spotify, SoundCloud, or direct URLs. | /play Bohemian Rhapsody |
| /pause | !pause |
Pause the currently playing audio stream. | /pause |
| /resume | !resume, !unpause |
Resume paused audio playback. | /resume |
| /skip | !skip, !s, !next |
Skip the current track and play the next queued item. | /skip |
| /queue [page] | !queue, !q |
View upcoming queued songs, durations, and estimated play times. | /queue page:1 |
| /nowplaying | !np, !current |
Display detailed playback progress bar and metadata for the current track. | /nowplaying |
| /bassboost <level> | !bb, !bass |
Apply low-end bass boost filter (None, Low, Medium, High, Extreme). | /bassboost level:High |
| /nightcore | !nc |
Speed up playback tempo and shift pitch for an anime nightcore feel. | /nightcore |
| /8d | !8d, !surround |
Enable 3D rotating binaural audio spatial filter. | /8d |
| /volume <1-200> | !vol, !v |
Adjust player output volume without distortion. | /volume percent:85 |
| /loop [mode] | !repeat |
Toggle loop mode (Off, Current Track, Entire Queue). | /loop mode:Track |
| /shuffle | !shuff |
Randomize the order of all tracks in the current queue. | /shuffle |
| /stop | !stop, !leave, !disconnect |
Stop playback, clear the server queue, and disconnect from voice. | /stop |
⭐ Complete Leveling & XP Command Reference (All 23 Commands)
Bee-Bota provides a rich progression ecosystem featuring XP curves, voice activity rewards, automated milestone roles, and admin management. All 23 commands and their shorthand aliases are cataloged below:
| Category | Command & Parameters | Aliases | Permissions | Description | Example |
|---|---|---|---|---|---|
| MEMBER | /rank [member] | /xp, /profile |
@everyone | Check your current level, total XP, progression bar, rank standing, and next level target. | /rank |
| MEMBER | /levels [page] | /leaderboard, /top |
@everyone | Display server XP leaderboard rankings with top members and pagination. | /levels page:1 |
| MEMBER | /levelroles | /levelrewards, /xproles |
@everyone | View all active milestone role rewards configured on the server. | /levelroles |
| MEMBER | /levelhelp | /xphelp, /rankhelp |
@everyone | Open interactive help menu and reference guide for all leveling commands. | /levelhelp |
| SPEED | /levelspeed <rate> | /xpspeed, /xpmultiplier |
Admin | Set global server XP multiplier (0.1x to 20x) for double XP events or slow grinds. | /levelspeed rate:2.0 |
| SPEED | /levelcurve <difficulty> | /xpcurve, /xpdifficulty |
Admin | Adjust XP curve steepness (Fast 0.5x, Normal 1.0x, Hardcore 2.0x, Extreme 3.0x). | /levelcurve difficulty:0.75 |
| SPEED | /voicexp <enabled> [min_xp] [max_xp] | /voicechatxp, /vcxp |
Admin | Enable or disable periodic XP rewards for members active in Voice Channels. | /voicexp enabled:True min_xp:15 max_xp:30 |
| SPEED | /levelrange <min_xp> <max_xp> | /xprange, /chatxprange |
Admin | Set minimum and maximum random XP granted per eligible chat message. | /levelrange min_xp:20 max_xp:40 |
| SPEED | /levelcooldown <seconds> | /xpcooldown, /chatcooldown |
Admin | Anti-spam cooldown (5 to 300 seconds) between awarded XP messages. | /levelcooldown seconds:45 |
| SPEED | /leveltoggle <enabled> | /xptoggle, /enableleveling |
Admin | Toggle server-wide leveling system on or off without wiping member XP data. | /leveltoggle enabled:False |
| CONFIG | /addlevelrole <level> <@role> | /setlevelrole, /rewardrole |
Admin | Automatically assign a prestige role when reaching a level milestone. | /addlevelrole level:5 role:@Bronze |
| CONFIG | /removelevelrole <level> | /dellevelrole, /unrewardrole |
Admin | Delete a milestone role reward by target level. | /removelevelrole level:5 |
| CONFIG | /levelignorechannel <channel> | /xpignorechannel, /levelignore |
Admin | Blacklist a specific channel (e.g. #bot-spam) from earning XP. | /levelignorechannel channel:#spam |
| CONFIG | /levelunignorechannel <channel> | /xpunignorechannel, /levelunignore |
Admin | Re-enable XP gain in a previously ignored channel. | /levelunignorechannel channel:#spam |
| CONFIG | /levelsettings | /xpsettings, /levelconfig |
Admin | View complete server leveling configuration summary, multipliers, and role rewards. | /levelsettings |
| ALERTS | /setlevelchannel [channel] | /levelchannel, /setlevelupchannel |
Admin | Route level-up celebrations to a dedicated channel (or reset to active chat if omitted). | /setlevelchannel channel:#level-ups |
| ALERTS | /setlevelmessage <message> | /setlevelupmsg, /levelmsg |
Admin | Custom level-up announcement template using {user}, {level}, {xp}, {server}. |
/setlevelmessage message:GG {user}! You reached level {level}! |
| ALERTS | /setlevelstyle [banner_url] [footer] | /levelbanner, /levelstyle |
Admin | Customize Creavite GIF banner animation and custom footer text. | /setlevelstyle footer:HAPPY GAMING 💚 |
| ADMIN | /givexp <member> <amount> | /awardxp, /addxp |
Admin | Award bonus XP directly to a member with automatic level-up checks and role grants. | /givexp member:@Alex amount:500 |
| ADMIN | /removexp <member> <amount> | /deductxp, /takexp |
Admin | Deduct XP from a member and gracefully recalculate down-leveling if necessary. | /removexp member:@Alex amount:200 |
| ADMIN | /setlevel <member> <level> [xp] | /setrank, /forcelevel |
Admin | Force set member's exact level and optional starting XP, syncing milestone roles. | /setlevel member:@Alex level:25 |
| ADMIN | /resetlevel <member> | /xpreset, /resetrank |
Admin | Reset a specific member's level and XP back to Level 1 / 0 XP. | /resetlevel member:@Alex |
| ADMIN | /resetalllevels | /wipelevels, /resetallxp |
Admin | Server-wide wipe of all member levels and XP (requires interactive modal/button confirmation). | /resetalllevels |
🛡️ Moderation Command Reference
Comprehensive moderation tools with audit logging and member enforcement:
| Command | Aliases | Permissions | Description | Example |
|---|---|---|---|---|
| /kick <member> [reason] | !kick |
Kick Members | Kick a user from the server with audit logging. | /kick member:@user reason:Breaking rules |
| /ban <member> [reason] [delete_days] | !ban |
Ban Members | Permanently ban a user and optionally purge recent message history. | /ban member:@user reason:Raid participation |
| /unban <user_id> [reason] | !unban |
Ban Members | Revoke a server ban by user ID. | /unban user_id:123456789 |
| /mute <member> <duration> [reason] | !timeout, !mute |
Moderate Members | Apply a Discord timeout to temporarily restrict member chat and voice. | /mute member:@user duration:1h reason:Spamming |
| /unmute <member> [reason] | !untimeout, !unmute |
Moderate Members | Remove an active timeout restriction from a member. | /unmute member:@user |
| /purge <count> [member] | !clear, !clean |
Manage Messages | Bulk delete up to 100 messages in the channel (optionally filtered by user). | /purge count:25 |
| /warn <member> <reason> | !warn |
Manage Messages | Issue a formal administrative warning stored in the server audit record. | /warn member:@user reason:Advertising in general |
| /warnings <member> | !warns |
Manage Messages | View active warning count and incident history for a member. | /warnings member:@user |
| /clearwarns <member> | !clearwarn |
Administrator | Clear all logged infractions and warnings for a member. | /clearwarns member:@user |
| /lock [channel] [reason] | !lockdown |
Manage Channels | Lock channel permissions to prevent members from sending messages during raids. | /lock reason:Server under raid |
| /unlock [channel] | !unlock |
Manage Channels | Restore normal chatting permissions to a previously locked channel. | /unlock |
| /slowmode <seconds> [channel] | !slow |
Manage Channels | Set rate limit cooldown between messages in seconds (0 to 21600). | /slowmode seconds:10 |
🧠 AI, Fun, Economy & Quiz Command Reference
Complete guide to Gemini AI assistant features, interactive trivia quizzes, and virtual economy:
| Command | Aliases | Category | Description | Example |
|---|---|---|---|---|
| /ask <prompt> | !ask, !ai |
Gemini AI | Query Google Gemini AI with high-speed reasoning and rich markdown answers. | /ask prompt:Explain black holes simply |
| /quiz start [category] [difficulty] | !quiz, !trivia |
Quizzes | Launch an interactive multiplayer trivia game with timer buttons and XP prizes. | /quiz start category:Science |
| /daily | !daily |
Economy | Claim your free daily coin reward (24 hour streak cooldown). | /daily |
| /work | !work |
Economy | Perform quick mini-jobs to earn coins with randomized humorous scenarios. | /work |
| /balance [member] | !bal, !coins |
Economy | Check your wallet coin balance and bank reserves. | /balance |
| /coinflip <bet> <heads/tails> | !cf, !flip |
Mini-Games | Wager coins on a 50/50 coin toss for double payout. | /coinflip bet:50 choice:heads |
| /roll [dice] | !dice |
Fun | Roll standard dice (e.g. 1d6, 2d20, 1d100) with cryptographic randomness. | /roll dice:2d6 |
| /8ball <question> | !magic8 |
Fun | Ask the mystical magic 8-ball for answers to life's dilemmas. | /8ball question:Will I win my next match? |
| /leaderboard | !richest, !topcoins |
Economy | Display the server leaderboard of wealthiest members. | /leaderboard |
❓ Troubleshooting & FAQ
Why is the bot not joining voice when I type /play?
Ensure Bee-Bota has the Connect and Speak permissions in the voice channel you are currently in. If permissions are restricted for @everyone, make sure to add a role override for Bee-Bota.
Why aren't level-up announcements sending to my chosen channel?
Verify that Bee-Bota has Send Messages and Embed Links permissions in the specific level-up channel you configured.
How do I invite more people or get official assistance?
Visit our Support Page to connect with the developer or report issues.