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 only user contains starts_with ends_with mode - Delete messages: filter by author or text, fast or slow.

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!remindme message time dm - Set a reminder for yourself. Duration can be part of the message.

n!reminders list - List your active reminders.

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

n!reminders user user message time dm - Set a reminder for someone else.

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

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

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

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!recurring 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!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!fun cookie user - Give someone a cookie, or open your cookie jar.

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

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!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!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!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 guildplaylist add url - Add a track or whole playlist to the guild playlist.

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

n!music guildplaylist list - Show the server guild playlist.

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

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

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

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

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

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

n!music queue - Show the upcoming queue.

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

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

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

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

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 announce channel - Set the level-up announcement channel (omit to use the current channel).

n!level globalannounce channel state - Where account-wide (global) level-ups are announced here.

n!level globalxp state - Opt this server in or out of the account-wide level system.

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 scope - Show the richest members.

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

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!coin contrib page scope - Show the top guild contributors (co-op leaderboard).

n!coin raidsize minimum maximum - Set the minimum and maximum raid party size.

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.

n!liverole setup role channel - Set the live role and/or channel

n!liverole enable - Enable live-role tracking

n!liverole disable - Disable live-role tracking

n!liverole role role - Set the role granted while live

n!liverole channel channel - Set the go-live announcement channel

n!liverole announce enabled - Toggle go-live announcements

n!liverole message text - Customize the announcement text

n!liverole status - Show the current configuration

n!birthday set date - Register your birthday (e.g. 'March 5', '5 Mar 1998', '03/05').

n!birthday remove - Delete your registered birthday.

n!birthday view member - Show a member's birthday and countdown.

n!birthday list - Show upcoming birthdays in this server.

n!birthday channel channel - Set the birthday announcement channel (turns the feature on).

n!birthday disable - Turn birthday announcements off.

n!birthday timezone timezone - Set the timezone used to decide 'today' (start typing to search).

n!birthday hour hour - Set the local hour (0-23) announcements fire.

n!birthday message text - Customize the announcement text ('default' resets it).

n!birthday gifs state - Toggle the festive GIF in announcements.

n!birthday voice state - Toggle joining voice to play the birthday song.

n!birthday ping state - Toggle pinging the birthday person.

n!birthday config - Show birthday settings.

n!birthday test member - Preview the birthday announcement now (doesn't affect the schedule).

n!raid activity - Start a group co-op anyone can join — the whole party earns coins!

n!shop browse - Spend your coins: profile looks, wallet looks, server rewards.

n!shop server page - Browse the rewards this server's mods set up.

n!shop profile page - Buy banners, borders, nameplates and badges for /profile.

n!shop wallet page - Buy banners and coin styles for your /balance card.

n!shop unlock cosmetic - Buy a profile or wallet cosmetic with your coins.

n!shop buy item - Redeem an item by its id or name.

n!shop add name price kind role reward description stock limit cooldown - Add a shop item (Manage Server).

n!shop seed - Fill an empty shop with starter rewards (Manage Server).

n!shop edit item price description reward stock limit cooldown enabled - Edit a shop item's fields (Manage Server).

n!shop remove item - Delete a shop item (Manage Server).

n!shop pending - List custom rewards awaiting fulfilment.

n!shop fulfill purchase_id - Mark a pending custom reward as delivered (Manage Server).

n!squad member member2 member3 member4 member5 activity - Squad up on a guild activity — everyone in the squad earns coins!

n!ticket open subject - Open a private support ticket.

n!ticket close reason - Close this ticket (opener or staff only).

n!ticket claim - Claim this ticket (staff only).

n!ticket add member - Add a member to this ticket (staff only).

n!ticket remove member - Remove a member from this ticket (staff only).

n!ticket setup staff_role log_channel max_open - Set the staff role (and optionally a log channel) for tickets.

n!ticket panel channel title message - Post the Open Ticket button panel in a channel.

n!ticket limit amount - Set how many tickets one member can have open at once.

n!ticket config - Show the ticket settings.

n!ticket enable - Turn the ticket system on.

n!ticket disable - Turn the ticket system off (open tickets stay usable).

n!anime type - Get a random anime image (husbando/kitsune/neko/waifu).

n!inventory view category - Your items: bait, consumables, materials, and treasure.

n!inventory use item qty - Use consumable items.

n!inventory sell item qty - Sell items for coins — one item, a whole category, or everything.

n!inventory give member item qty - Give items to another member.

n!inventory info item - See what an item is and does.

n!casino overview - Casino minigames — bet NanoCoins on flip, dice, slots, roulette, or blackjack.

n!casino flip bet side - Bet on a 50/50 coin flip.

n!casino dice bet - Roll 2d6 against the dealer.