NanoBot Commands

n!cban user days wait message - Ban + delete message history. Optional timed unban & DM.

n!ban user message - Permanently ban a user with an optional DM.

n!unban user_id reason - Unban a user by their User ID. Omit ID to unban the last person you banned.

n!kick user message - Kick a user. Defaults to last message sender.

n!slow delay length - Toggle slowmode. No args = toggle. Add delay and optional timer.

n!lock channel reason - Toggle @everyone channel lock. Run again to unlock.

n!purge amount bots user contains starts_with ends_with - Bulk delete messages with optional filters.

n!freeze user duration reason - Timeout a user (default 10m). They can't speak, react, or join VCs.

n!unfreeze user - Remove a timeout from a user early.

n!note add user content - Add a private mod note about a user.

n!note list user - View mod notes for a user.

n!note clear user - Delete all mod notes for a user. Admin only.

n!last - Show who last sent a message here.

n!tag create name content image image_url - Create a personal tag with optional image.

n!tag global name content image image_url - Create a global server tag usable by anyone. Mods only.

n!tag use name dm_user - Post a tag in this channel, or DM it to a specific user.

n!tag preview name - Preview a tag — only you see this response.

n!tag edit name new_content image image_url - Edit a tag's content and/or image.

n!tag delete name - Delete a tag (personal, or global if you're a mod).

n!tag list - List your personal tags and global server tags.

n!tag export - Download all your personal tags as a JSON file you can re-import later.

n!tag import file - Import personal tags from a file exported by /tag export.

n!help command - Command reference. Use /help <command> for detail, or /help <category> to browse.

n!prefix new_prefix - View or change NanoBot's prefix for this server.

n!server guild_id - Info card for this server.

n!user user - Public info card for a user.

n!avatar user - Show a user's avatar in full size.

n!banner user - Show a user's profile banner.

n!roleinfo role - Info card for a server role.

n!remindme message time dm - Set a reminder for yourself. Duration can be part of the message.

n!remind user message time dm - Set a reminder for another user.

n!reminders list - List your active reminders.

n!reminders cancel number - Cancel an active reminder by its list number.

n!massban user_ids reason - Ban multiple users by ID. Paste IDs separated by spaces.

n!snailpurge amount - Slow delete of older messages (no 14-day limit). Requires confirmation.

n!clean amount - Delete recent NanoBot messages from this channel.

n!addrole user role - Give a role to a user.

n!removerole user role - Remove a role from a user.

n!channelinfo channel - Info card for a channel.

n!tempban user duration reason - Ban a user for a set duration. Auto-unbans when it expires.

n!nuke reason - Clone this channel and delete the original — permanently wipes all messages.

n!hide channel - Hide a channel from @everyone.

n!unhide channel - Restore @everyone visibility on a hidden channel.

n!echo message channel - Send a message as NanoBot.

n!moveall to_channel from_channel - Move all members from one voice channel to another.

n!warn issue user reason - Issue a warning to a user.

n!warn list user - View all warnings for a user.

n!warn clear user - Clear all warnings for a user. Admin only.

n!warn config kick_at ban_at dm_user - Configure auto-actions for warnings.

n!welcome set enabled channel title content image_url image_text footer_text thumbnail color dm - Configure the welcome message.

n!welcome test - Preview the welcome message as if you just joined.

n!leave set enabled channel title content image_url image_text footer_text thumbnail color dm - Configure the leave message.

n!leave test - Preview the leave message as if you just left.

n!vote action - Vote for NanoBot on bot lists and see your voting status.

n!every interval message label dm - Set a recurring reminder — like a repeating calendar event.

n!recurring list - List all your recurring reminders.

n!recurring pause reminder_id - Pause a recurring reminder — it won't fire until you resume it.

n!recurring resume reminder_id - Resume a paused recurring reminder.

n!recurring cancel reminder_id - Permanently delete a recurring reminder.

n!auditlog channel channel - Set the channel for audit log entries.

n!auditlog enable - Enable the audit log.

n!auditlog disable - Disable the audit log.

n!auditlog events - Toggle which events get logged.

n!auditlog status - Show the current audit log configuration.

n!automod status - Show the current AutoMod configuration.

n!automod enable - Enable AutoMod for this server.

n!automod disable - Disable AutoMod for this server.

n!automod logchannel channel - Set a dedicated channel for AutoMod action logs. Omit to clear (falls back to audit log).

n!automod rule rule enabled action dm_message - Toggle a rule on/off and set its action.

n!automod spam count seconds - Set the spam detection threshold (messages per time window).

n!automod caps percent min_length - Configure the caps-abuse filter.

n!automod mentions limit - Set the max @mentions allowed in a single message.

n!automod timeout minutes - Set how long the timeout action lasts (default: 10 minutes).

n!automod badword add word - Add a word to the filter.

n!automod badword remove word - Remove a word from the filter.

n!automod badword list - List all filtered words (shown only to you).

n!automod attachments min_attachments - Set the minimum attachment count that triggers the Word + Attachment rule.

n!automod attachword add word - Add a word to the attachment-word filter.

n!automod attachword remove word - Remove a word from the attachment-word filter.

n!automod attachword list - List all words in the attachment-word filter (shown only to you).

n!automod regex add pattern label - Add a regex pattern to the filter.

n!automod regex remove pattern - Remove a regex pattern from the filter.

n!automod regex list - List all regex patterns in the filter (shown only to you).

n!automod regex test text - Test a string against all active regex patterns (shown only to you).

n!automod ignore channel channel - Toggle a channel exemption.

n!automod ignore role role - Toggle a role exemption.

n!roles panel create title description mode - Create a new role panel (not posted yet).

n!roles panel post panel_id channel - Post (or re-post) a panel to a channel.

n!roles panel edit panel_id title description mode - Edit a panel's title, description, or mode.

n!roles panel delete panel_id - Delete a panel and remove its message.

n!roles panel list - List all role panels in this server.

n!roles panel reload - Re-post all panels in this server to refresh their messages.

n!roles add panel_id role label emoji style - Add a role to a panel.

n!roles remove panel_id role - Remove a role from a panel.

n!roles autogen colors channel prefix extra_role_1 extra_role_2 extra_role_3 extra_role_4 extra_role_5 - Generate 18 cosmetic colour roles and a single-choice colour panel.

n!roles autogen pronouns channel extra_role_1 extra_role_2 extra_role_3 extra_role_4 extra_role_5 - Generate She/Her, He/Him, They/Them, It/Its, Any/All roles and a panel.

n!roles autogen age channel extra_role_1 extra_role_2 extra_role_3 extra_role_4 extra_role_5 - Generate age-range roles (13-17, 18-20, 21-25, 26-30, 31+) and a panel.

n!roles autogen region channel extra_role_1 extra_role_2 extra_role_3 extra_role_4 extra_role_5 - Generate 7 world-region roles (N. America, Europe, Asia…) and a panel.

n!eli5 topic - Explain a topic like I'm 5 years old.

n!fun social action user - Social interactions -- hug, kiss, slap, and more!

n!fun react action - Express yourself -- cry, dance, laugh, and more!

n!fun ship user1 user2 - Ship two users! 💕

n!fun 8ball question - Ask the magic 8-ball. 🎱

n!fun fml - Get a random FML story from fmylife.com

n!fun thigh - Random anime thigh pic (SFW)

n!fun wyr duration - Would You Rather -- vote with buttons!

n!fun rps user - Rock Paper Scissors -- challenge someone or the bot!

n!husbando - Get a random husbando image.

n!kitsune - Get a random kitsune image.

n!neko - Get a random neko image.

n!waifu - Get a random waifu image.

n!modcheck user - Full mod snapshot — user info, warnings, and notes in one embed.

n!mc - Quick member count for this server.

n!id target - Get the ID of a user, role, or channel — copyable code block.

n!firstmsg channel - Get a link to the first (oldest) message in a channel.

n!play query mode - Play a song or playlist — paste a URL or type search terms.

n!search terms - Search for a track and pick a result from a menu.

n!skip - Vote to skip the current track.

n!forceskip - Force-skip the current track (Manage Server).

n!jump position - Skip ahead to a track at a given queue position.

n!stop - Stop playback, clear the queue, and leave the channel.

n!pause - Pause the current track.

n!resume - Resume a paused track.

n!nowplaying - Show the live Now Playing card.

n!queue - Show the upcoming queue.

n!move from_pos to_pos - Move a queued track to a new position.

n!remove position - Remove a track from the queue by its position.

n!clear - Empty the queue (keeps the current track playing).

n!shuffle - Shuffle the queue.

n!volume amount - Show, set, or adjust the playback volume (0-200).

n!speed rate - Set or adjust playback speed (0.5-3.0).

n!filter name - Apply an audio effect (bassboost, nightcore, vaporwave…).

n!loop mode - Cycle loop mode: off → track → queue.

n!seek position - Jump to a position in the current track (e.g. 1:30, 90, or +30/-30).

n!replay - Restart the current track from the beginning.

n!join - Connect the bot to your voice channel.

n!blocksong add pattern - Block a song URL, word, or phrase from being queued.

n!blocksong remove pattern - Remove a pattern from the music block list.

n!blocksong list - Show the server's music block list.

n!blockuser add member - Bar a member from using music commands here.

n!blockuser remove member - Let a blocked member use music commands again.

n!bot support - Link to the NanoBot support server.

n!bot ping - Check NanoBot's latency.

n!bot invite - Get NanoBot's invite link.

n!bot about - What NanoBot is and why it exists.

n!bot uptime - How long NanoBot has been running.

n!bot stats - NanoBot runtime statistics.

n!bot source command - Show source for a command or symbol.

n!music grab - Save the currently playing track to your DMs.

n!music lyrics query - Look up lyrics for a song.

n!music autoplay state - Toggle smart autoplay (queues YouTube-related tracks).

n!music guildplay state - Toggle playback from the server guild playlist.

n!music radio state - Toggle 24/7 stay-connected mode.

n!music stream url - Queue a live stream or direct media URL.

n!music follow - Toggle the bot following you between channels.

n!music pldump - Export the queue's URLs to a text file.

n!music history - Show recently played tracks.

n!music clearhistory - Clear this server's played-track history.

n!rank member - Show your level, XP, and rank on this server.

n!level top page - Show the server XP leaderboard.

n!level set member amount - Set a member's XP to an exact amount.

n!level give member amount - Add (or subtract) XP for a member.

n!level reset member - Reset XP for one member, or the whole server.

n!level toggle state - Turn leveling on or off.

n!level rate xp_min xp_max cooldown - Set XP earned per message and the cooldown.

n!level coinreward amount - Coins awarded per level on level-up (amount × new level). 0 = off.

n!level announce channel - Set the level-up announcement channel (omit to use the current channel).

n!level reward action level role - Manage role rewards: reward add <level> <role> | remove <level> | list

n!level ignore action channel - Manage no-XP channels: ignore add <channel> | remove <channel> | list

n!level config - Show the current leveling settings.

n!balance member - Check your NanoCoin balance, or someone else's.

n!daily - Claim your daily NanoCoins. Keep a streak for bonus coins!

n!pay member amount - Send some of your NanoCoins to another member.

n!coin top page - Show the richest members.

n!coin gamble amount - Bet some coins for a chance to double them.

n!coin grant member amount - Add coins to a member's balance.

n!coin take member amount - Remove coins from a member's balance.

n!coin reset member - Reset coins for one member, or the whole server.

n!coin daily amount - Set the daily reward amount.

n!coin streakbonus amount - Set the bonus coins added per consecutive daily streak day.

n!coin name name - Set the currency name (e.g. NanoCoin).

n!coin emoji emoji - Set the currency emoji.

n!coin config - Show the current economy settings.

n!guildplaylist add url - Add a track or whole playlist to the guild playlist.

n!guildplaylist remove position - Remove a track from the guild playlist by position.

n!guildplaylist list - Show the server guild playlist.

n!guildplaylist clear - Remove every track from the guild playlist.

n!gatekeeper setup - Create the Muted role and lock it down.

n!gatekeeper status - Show the current gatekeeper settings.

n!gatekeeper enable - Enable the gatekeeper.

n!gatekeeper disable - Disable the gatekeeper.

n!gatekeeper role role - Use an existing role as the mute role.

n!gatekeeper channel channel - Set the fallback quarantine channel.

n!gatekeeper logchannel channel - Set the gatekeeper log channel.

n!gatekeeper minage duration - Mute accounts younger than this.

n!gatekeeper unmuteage duration - Auto-unmute once accounts reach this age.

n!gatekeeper kicktimeout duration - Kick unverified members after this long.

n!gatekeeper newaccounts enabled - Toggle muting by account age.

n!gatekeeper noavatar enabled - Toggle muting members with no avatar.

n!gatekeeper stockavatar enabled - Toggle muting catalogued stock avatars.

n!gatekeeper verify enabled - Toggle captcha verification.

n!gatekeeper message text - Set the verification prompt text.

n!gatekeeper learnavatar user url - Add an avatar to the stock-avatar catalog.

n!gatekeeper checkavatar user - Test whether a member's avatar matches the catalog.

n!gatekeeper sensitivity distance - How close an avatar must match the catalog (0=exact, higher=looser).

n!gatekeeper matchmode mode - How the account-age and avatar checks combine to mute.

n!gatekeeper ageunmute enabled - Auto-unmute age-flagged members once they're old enough.