BMO All commands 📖
Every command BMO understands, grouped by feature. Almost everything here can also be configured from the dashboard — commands are the in-Discord alternative.
How to read this page
Each command is tagged with how you type it and who can use it:
- slash — type
/in Discord and pick the command from the menu. - prefix — type it as a normal message starting with
!(for example!ping). - Both badges together mean the command works either way — use whichever you prefer.
- admin — staff only: it needs Manage Server, Administrator, or a moderation role you've approved.
Jump to a module:
- Basics: Help · Ping · Dashboard link
- Moderation: Jail & bans · Warnings & intro finder · Send as the bot · Snipe · Channel nuke · Inactive-member purge
- Protection: Anti-nuke · Security & auto-ban · NSFW spoiler guard · Audit logs
- Welcome & onboarding: Welcome messages · Intros & activity · Rules poster
- Roles & rewards: Self roles · Auto reactions · Booster custom roles · Rep & vanity rewards
- Voice: Voice hub · VoiceMaster controls · Voice listening
- Fun: Music · AI & word games · Mafia
- Owner: Bot management
Help
The built-in guide to everything on this page, right inside Discord.
| Command | Type | What it does |
|---|---|---|
/help | slash prefix | Opens an interactive help menu with 14 sections, a section picker, next/back buttons, and a dismiss button. Replaces Discord's plain built-in help. |
Ping
The quickest way to check the bot is alive and responsive.
| Command | Type | What it does |
|---|---|---|
/ping | slash prefix | Shows the bot's gateway latency and response time in an embed. |
Dashboard link
Forgot the dashboard address? Ask the bot.
| Command | Type | What it does |
|---|---|---|
/dashboard | slash admin | Shows the web dashboard URL, whether it's running, and the sign-in mode. Only admins can use it, and the reply is visible only to you. |
Jail & bans
The jail system isolates a troublemaker in one command: their roles are saved, they're locked into a single jail channel, and everything is logged. Set it up from the dashboard under Setup → Jail (which can auto-create the role and channel for you), or with the commands below. Full guide: Moderation & jail.
| Command | Type | What it does |
|---|---|---|
/setadmin add|remove|list @role | slash prefix admin | Choose which roles are allowed to use the jail and ban commands. Requires Administrator. |
/jailsetup | slash prefix admin | Creates the jailed role and the jail channel, then locks permissions in every channel so jailed members can only see the jail. |
/jailre | slash prefix admin | Re-applies the jail permission locks to all channels — run it after creating new channels so they're covered too. |
/jail @user reason | slash prefix admin | Jails a member (reason required). Their roles are snapshotted so they can be restored later, the jail channel is notified, and the action is logged. |
/unjail @user reason | slash prefix admin | Releases a jailed member (reason required): removes the jailed role and clears their jail record. |
/ban @user reason | slash prefix admin | Bans a user — accepts a mention, an ID, or a name — with a required reason, and posts a ban-notice embed you can customise on the dashboard's Embeds page. |
/setadmin — regular members can never use them.
Warnings & intro finder
Lightweight tools for everyday moderation: keep a written record of warnings, and quickly find what a member posted in your introductions channel. Warning history is also visible on the dashboard's Moderation page.
| Command | Type | What it does |
|---|---|---|
/warn @user reason | slash prefix admin | Records a warning for a member (up to 50 stored per member) and mirrors it to your audit log and analytics. Needs Manage Messages. |
/warnings @user | slash prefix admin | Shows a member's stored warnings (the five most recent in an embed). Needs Manage Messages. |
/find @user | slash prefix admin | Searches your intro channel for a member's messages, scores how intro-like each one is, and shows them in a paged browser with a "remind them" button. Needs Manage Messages. |
/findset #channel | slash prefix admin | Sets which channel /find searches. Also on the dashboard under Setup → Mod commands. Needs Manage Server. |
Send as the bot
Post announcements in the bot's voice instead of your own. The dashboard equivalent is Setup → Send message, which has a channel picker and text box.
| Command | Type | What it does |
|---|---|---|
/send | slash prefix admin | Sends a message to any channel as the bot, with a confirmation step before it goes out. Needs Manage Messages. |
Snipe
See what was just deleted — handy when someone posts something and removes it before staff can look.
| Command | Type | What it does |
|---|---|---|
/snipe | slash prefix | Shows messages deleted in the last 10 minutes in a paged embed. Not open to everyone: only staff and holders of your rep, booster, media, or whitelist roles can use it. |
Channel nuke
"Nuking" a channel wipes its entire message history by deleting the channel and instantly recreating an identical copy — same name, permissions, topic, and position.
| Command | Type | What it does |
|---|---|---|
/nuke [#channel] | slash prefix admin | Deletes and recreates a text or voice channel with identical settings, clearing all messages. Requires Administrator, and the bot needs Manage Channels. |
Inactive-member purge
Trim members who joined long ago and never participate. Candidates are grouped into tiers
(ghost, dormant, lurker) so you can start with the safest group. The dashboard's
Purge page is review-only — it lists candidates and writes out ready-to-paste
/purge execute commands, but the actual kicking always happens in Discord.
| Command | Type | What it does |
|---|---|---|
/purge preview | slash admin | Lists inactive-member candidates by tier without kicking anyone. |
/purge execute | slash admin | Kicks inactive members in a chosen tier. The dry_run option defaults to ON, so nothing happens until you explicitly turn it off. Every kick is recorded as a moderation action. |
/purge whitelist-add @role | slash admin | Protects a role — members holding it are never purged. |
/purge whitelist-remove @role | slash admin | Removes a role from the purge whitelist. |
/purge preview first, and keep dry_run on for
your first /purge execute — you'll see exactly who would be kicked before anything
happens.
Anti-nuke
Anti-nuke watches for someone (a rogue mod, a compromised account, a malicious bot) doing mass damage — waves of bans, kicks, or channel deletions — and reacts automatically. The easiest way to configure it is the dashboard's Setup → Anti-nuke page; the commands below do the same from Discord. All of them are admin-only. Full guide: Anti-nuke.
| Command | Type | What it does |
|---|---|---|
/antinuke | slash prefix admin | With no subcommand, shows your current anti-nuke configuration in one embed. |
/antinuke status | slash prefix admin | Shows the configuration plus any bot permissions that are missing for enforcement to work. |
/antinuke enable | slash prefix admin | Turns protection on or off (leave the value out to toggle). |
/antinuke cooldown | slash prefix admin | Sets the detection window in seconds (3–300) — how far back the bot looks when counting destructive events. |
/antinuke overload | slash prefix admin | Sets how many destructive events inside the window (2–30) count as an attack. |
/antinuke action | slash prefix admin | Chooses what happens when triggered: notify (alert only), kick, ban, or strip (remove the offender's roles). |
/antinuke logchannel | slash prefix admin | Sets or clears a dedicated anti-nuke log channel. If unset, alerts fall back to your audit log or security log channel. |
/antinuke ignorebots | slash prefix admin | Toggles whether bot accounts are ignored by anti-nuke detection. |
/antinuke dm | slash prefix admin | Toggles sending the offender a DM explaining what happened when anti-nuke acts. |
/antinuke wladd @user | slash prefix admin | Whitelists a trusted user so anti-nuke never acts against them. |
/antinuke wlremove @user | slash prefix admin | Removes a user from the whitelist. |
/antinuke wllist | slash prefix admin | Lists everyone on the anti-nuke whitelist. |
Security & auto-ban
A small safety net: a log channel for security events, plus an optional "ban role" — assign that role to someone and the bot bans them immediately. Useful as a one-click ban for staff who can manage roles but not bans. Dashboard: Setup → Security.
| Command | Type | What it does |
|---|---|---|
/securitystatus | slash prefix admin | Shows the auto-ban trigger role, the log channel, and whether the bot has the permissions it needs. |
/log #channel | slash prefix admin | Sets the channel where security events are posted. |
/banonrole @role | slash prefix admin | Sets the role that triggers an automatic ban the moment it's assigned to a member. |
NSFW spoiler guard
Watches for NSFW content hidden behind spoiler tags in channels where it doesn't belong and alerts your staff. Dashboard: Setup → NSFW guard.
| Command | Type | What it does |
|---|---|---|
/nsfwguardstatus | slash prefix admin | Shows the guard's configuration and whether the bot can manage messages. |
/nsfwguardchannel #channel | slash prefix admin | Sets the channel where violation alerts are posted for staff review. |
/nsfwguardrole @role | slash prefix admin | Sets (or clears) the role that gets pinged on each alert. |
Audit logs
The audit log channel is where BMO posts a running record of what happens in your server — joins, leaves, deletions, moderation actions, and more. Dashboard: the Log channels form on your server's Overview page, or Setup → Audit logs.
| Command | Type | What it does |
|---|---|---|
!logs set #channel | prefix admin | Sets the audit log channel and refreshes the invite cache (used to work out which invite new members arrived through). |
Welcome messages
Greet new members with a custom embed the moment they join. The dashboard's Setup → Welcome & goodbye page covers everything here plus goodbye messages and a live embed editor. Full guide: Welcome & intros.
| Command | Type | What it does |
|---|---|---|
!welcome add #channel | prefix admin | Quick way to set the welcome channel. |
/welcomeset | slash prefix admin | Configures (or shows) the welcome channel, the rules channel it points members to, and the three emojis used in the welcome embed. |
Intros & activity
The intro system nudges new members to introduce themselves, tracks who has and hasn't, and can eventually remove members who never say a word. It's the most involved module, so we recommend configuring it on the dashboard (Setup → Intro & onboarding) and using these commands for day-to-day checks. Most of them are prefix-only.
| Command | Type | What it does |
|---|---|---|
!introsetup | prefix admin | One-shot setup: picks the welcome and intro channels, an optional onboarding role gate, and starts a scan of past intros so existing members get credit. |
!introbackfill | prefix admin | Re-scans the intro channel's history to mark members who already posted an intro. |
/introemoji | slash prefix admin | Sets or shows the emoji used in intro welcome embeds. |
!intromingrace | prefix admin | Sets or shows how many seconds to wait after someone joins (and passes screening) before prompting them for an intro. |
/needsintro | slash prefix admin | A paged list of members who still haven't posted an intro, with a button to queue reminder DMs. The slash version replies privately; the prefix version DMs (or posts) the list. |
!status | prefix admin | Shows how many members currently count as inactive kick candidates, with a preview. |
!inactivekick | prefix admin | Kicks long-inactive members — but only after a confirm/cancel button prompt. Requires Administrator. |
!safelist | prefix admin | Adds, removes, or lists users and roles that are exempt from inactivity kicks. Boosters are automatically exempt. Requires Administrator. |
!activity | prefix admin | An activity report for the last N days: a message chart, joins and leaves, and the top channels, members, and keywords. |
!inactivekick and !safelist require full
Administrator permission, not just Manage Server — removing members is a bigger deal than
changing settings.
Rules poster
BMO can post your server rules as a polished embed with a banner image, and edit the same message in place whenever you change them — no more deleting and reposting. Dashboard: Setup → Rules, where you can also edit the rules embed with a live preview.
| Command | Type | What it does |
|---|---|---|
/ruleset #channel | slash prefix admin | Sets the rules channel (and forgets any previously posted rules messages, so the next post starts fresh). |
/rulesimage | slash prefix admin | Sets a custom banner image URL for the rules post, or shows the current one if you leave it out. |
/postrules | slash prefix admin | Posts the banner and rules embed in the configured channel — or edits the existing post in place — with optional pinning. |
Self roles
Let members give themselves roles (age, pronouns, colors, interests) by reacting to a panel. The dashboard's Setup → Self roles page has a full builder for up to 12 custom panels plus one-off reaction roles on any message — it's the recommended way. The commands cover the built-in starter panels. Full guide: Self roles & reactions.
| Command | Type | What it does |
|---|---|---|
!selfrole setup #channel | prefix admin | Creates the needed roles, posts the built-in age / gender / colors reaction panels in the chosen channel, and adds the reactions. |
/selfroleemoji | slash prefix admin | Lists, sets, or resets the emojis used by the built-in self-role panels. |
Auto reactions
Have the bot automatically react to messages — for example a ⭐ on everything in your showcase channel, or a reaction only on messages with attachments. Rules can target one channel or the whole server, and can filter by content type (all messages, attachments, embeds, links, or stickers). Dashboard: Setup → Auto reaction.
| Command | Type | What it does |
|---|---|---|
/autoreact | slash prefix admin | With no subcommand, shows usage help for the group. |
/autoreact add | slash prefix admin | Adds a rule for one text channel with a content filter (all / attachments / embeds / links / stickers). |
/autoreact addserver | slash prefix admin | Adds a server-wide rule covering every text channel. |
/autoreact list | slash prefix admin | Lists your rules with their index numbers. |
/autoreact remove | slash prefix admin | Removes one rule by its number from the list. |
/autoreact clear | slash prefix admin | Deletes all auto-reaction rules at once. |
Booster custom roles
A perk for your server boosters: their own personal role with a custom name, emoji, and icon. On the dashboard (Setup → Booster roles) you can also pick an extra role that unlocks this perk for non-boosters.
| Command | Type | What it does |
|---|---|---|
/br [emoji] role name | slash prefix | Creates or updates the booster's personal custom role. The prefix form also accepts an attached image to use as the role icon. Boosters (and the reward role) only. |
/bricon | slash prefix | Uploads a role icon from an attached image, with an optional rename at the same time. Boosters only. |
Rep & vanity rewards
Reward members who rep your server — putting your vanity link or server tag in their status — with special roles that sync automatically. Configure the trigger text and reward roles on the dashboard's Setup → Vanity & rep page.
| Command | Type | What it does |
|---|---|---|
/repstatus | slash prefix | Shows your own qualification: which rep signals the bot sees for you, which roles you hold, and your current tag snapshot. Anyone can use it. |
/repsync | slash prefix admin | Forces a rep / booster / media role sync for one member — or the whole server with a strict reconcile that removes roles from anyone who no longer qualifies. |
Voice hub
Pick one "hub" voice channel; whenever someone joins it, the bot creates a personal voice room for them and moves them in. Empty rooms clean themselves up. Dashboard: Setup → Dynamic voice. Full guide: Voice rooms.
| Command | Type | What it does |
|---|---|---|
/sethubvc | slash prefix admin | Sets the hub voice channel that spawns personal rooms. |
VoiceMaster controls
Owners of personal voice rooms control them through a button panel — Lock, Unlock, Ghost, Reveal, Claim, Disconnect, Start, View, Increase, Decrease — so members never need to learn commands. You post the panel once; the dashboard can do it too (Setup → VC control panel), where the panel text is also editable.
| Command | Type | What it does |
|---|---|---|
/vcpanel | slash prefix admin | Posts the persistent VoiceMaster button panel in the current channel. |
/vckick @user | slash prefix | Lets the owner of a personal voice room disconnect one member from it. |
/vcdisconnectall | slash prefix | Lets the owner disconnect everyone from their room at once. |
Voice listening
An experimental feature: the bot joins a voice channel and transcribes speech locally, watching for trigger phrases you define — useful for catching slurs or specific words in voice chat and alerting staff. Its settings live in their own store, so this module is configured entirely by command rather than on the dashboard.
| Command | Type | What it does |
|---|---|---|
/listen | slash prefix | The bot joins your current voice channel and starts transcribing, watching for trigger phrases. |
/stoplisten | slash prefix | Stops listening and leaves the voice channel. |
/setlogchannel #channel | slash prefix admin | Sets the text channel where trigger alerts and transcripts go. |
/setnotifyrole @role | slash prefix admin | Sets the role that gets pinged when a trigger phrase is detected. |
/addtrigger | slash prefix admin | Adds a trigger phrase to watch for. |
/removetrigger | slash prefix admin | Removes a trigger phrase. |
/listtriggers | slash prefix | Lists the configured trigger phrases. |
/transcriptdebug | slash prefix admin | Toggles posting full transcript debug output to the log channel. |
/whisperstatus | slash prefix | Shows the listening settings and whether the bot is currently in a channel listening. |
Music
Simple music playback in voice channels from a URL or search. All music commands are prefix-only. Full guide: Music.
| Command | Type | What it does |
|---|---|---|
!play <url or search> | prefix | Queues and plays audio in your voice channel. Shortcut: !p. |
!skip | prefix | Skips the track that's playing. |
!queue | prefix | Shows what's playing now and what's up next. Shortcut: !q. |
!stop | prefix | Stops playback, clears the queue, and disconnects the bot. |
AI & word games
Ask the AI questions, or play quick word games where the AI picks the word, writes the trivia question, or invents the riddle. One game of each type runs per channel, and the person who started a game (or staff) can end it early. Full guide: Games.
| Command | Type | What it does |
|---|---|---|
/ai <question> | slash prefix | Ask the AI anything. Each person can ask once every 8 seconds. |
!hangman | prefix | Shows hangman usage help. |
/hangman start [difficulty] | slash prefix | Starts hangman with an AI-picked word (easy / medium / hard). |
/hangman guess <letter> | slash prefix | Guesses a letter — typing single letters in chat works too. |
/hangman quit | slash prefix | Ends the game (starter or staff) and reveals the word. |
!scramble | prefix | Shows word-scramble usage help. |
/scramble start [difficulty] | slash prefix | Starts a word scramble with an AI-picked word. |
/scramble guess <word> | slash prefix | Submits an unscramble guess (5 attempts) — bare words in chat also count. |
/scramble quit | slash prefix | Ends the game (starter or staff) and reveals the word. |
!trivia | prefix | Shows trivia usage help. |
/trivia start [difficulty] [category] | slash prefix | The AI writes a multiple-choice trivia question at your chosen difficulty and category. |
/trivia answer <A|B|C|D> | slash prefix | Answers the current question. |
/trivia quit | slash prefix | Ends trivia without answering (starter or staff). |
!riddle | prefix | Shows riddle usage help. |
/riddle start [difficulty] | slash prefix | The AI writes a riddle to solve — you get 3 wrong guesses. |
/riddle guess <answer> | slash prefix | Submits an answer — chat replies count too. |
/riddle quit | slash prefix | Ends the riddle (starter or staff) and reveals the answer. |
Mafia
The classic social deduction game, run entirely by the bot: it DMs secret roles, runs the night phase, and tallies day votes. You need at least 5 players. Full guide: Games.
| Command | Type | What it does |
|---|---|---|
!mafia | prefix | Shows Mafia usage help. |
/mafia start | slash prefix | Opens a lobby in the current text channel. |
/mafia join | slash prefix | Joins the lobby in this channel. |
/mafia leave | slash prefix | Leaves the lobby — or forfeits (you're marked dead) if the game already started. |
/mafia players | slash prefix | Lists the players and who's still alive. |
/mafia begin | slash prefix | Starts the game (host or staff, minimum 5 players): secret roles go out by DM and the first night begins. |
/mafia night [@player] | slash prefix | Submits your night action (killer / doctor / nurse) — a fallback for when DMs don't arrive. |
/mafia vote [@player] | slash prefix | Casts (or skips) your day vote — also a fallback for when DMs fail. |
/mafia cancel | slash prefix | Cancels the lobby or the running game (host or staff). |
/mafia night and /mafia vote in the
channel.
Owner: bot management
These commands manage the bot's own code modules and only work for the bot owner — server admins can't use them. If you self-host BMO, they let you reload features without restarting the bot.
| Command | Type | What it does |
|---|---|---|
/cogs | slash prefix admin | Lists the currently loaded modules. |
/cogload | slash prefix admin | Loads a module by path and re-syncs the slash-command tree. |
/cogreload | slash prefix admin | Reloads a module (or loads it if it wasn't loaded) and re-syncs. |
/cogunload | slash prefix admin | Unloads a module (it refuses to unload the manager itself). |
/cogreloadall | slash prefix admin | Reloads every module and re-syncs all slash commands. |