Commands

All available Percy commands, grouped by category and section — the same sections as help in Discord. 436 commands.

AniList 10

anilist Slash Look things up on AniList.
Percy needs Read Messages
Link to this command
Subcommands (9)
anilist anime Slash Search for an anime and open its card.
Usage
anilist anime <prompt> [flags=Namespace(limit=15)]
Percy needs Read Messages
Link to this command
anilist anime airing Slash Anime episodes airing in the next few days, soonest first.
Usage
anilist anime airing [days=1]
Percy needs Read Messages
Link to this command
anilist anime seasonal Slash The most popular anime of a season, the current one by default.
Usage
anilist anime seasonal [season] [year]
Percy needs Read Messages
Link to this command
anilist character Slash Search for a character and open their card.
Usage
anilist character <prompt> [flags=Namespace(limit=15)]
Aliases char
Percy needs Read Messages
Link to this command
anilist manga Slash Search for a manga and open its card.
Usage
anilist manga <prompt> [flags=Namespace(limit=15)]
Percy needs Read Messages
Link to this command
anilist staff Slash Search for a voice actor, director, author or other staff member.
Usage
anilist staff <prompt> [flags=Namespace(limit=15)]
Aliases person
Percy needs Read Messages
Link to this command
anilist studio Slash Search for a studio and see what it is known for.
Usage
anilist studio <prompt> [flags=Namespace(limit=15)]
Percy needs Read Messages
Link to this command

Comics 5

comics Slash Group command for managing comic feeds.
Aliases comic
Percy needs Read Messages
Link to this command
Subcommands (4)
comics config Slash Show/Edit the current configuration for comic feeds.
Usage
comics config <brand> [flags=Namespace(channel=None, day=None, ping=None, format=None, pin=False, reset=False)]
You need Manage Channels
Percy needs Read Messages
Link to this command
comics current Slash Lists this week's/month's comics!
Usage
comics current <brand>
Percy needs Read Messages
Cooldown2 uses per 30s
Link to this command
comics push Slash Triggers your current feed configuration.
Usage
comics push <brand>
You need Manage Channels
Percy needs Read Messages
Cooldown3 uses per 30s
Link to this command
comics subscribe Slash Sets up a comic pulls feed.
Usage
comics subscribe <brand> [channel] [_format=SUMMARY]
You need Manage Channels
Percy needs Read Messages
Link to this command

Config 28

General

config Prefix Handles the server or channel permission configuration for the bot.
Aliases conf
Percy needs Read Messages
Link to this command

Ignoring

config ignore Prefix Ignores text channels or members from using the bot.

Ignores text channels or members from using the bot. If no channel or member is specified, the current channel is ignored. Notes ----- Users with Administrator can still use the bot, regardless of ignore status.

Usage
config ignore [entities...]
Aliases plonk
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
Subcommands (3)
config ignore all Prefix Ignores every channel in the server from being processed.

Ignores every channel in the server from being processed. This works by adding every channel that the server currently has into the ignore list. If more channels are added, then they will have to be ignored by using the ignore command.

You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config ignore clear Prefix Clears all the currently set ignores.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config ignore list Prefix Tells you what channels or members are currently ignored in this server.
You need Ban MembersManage Messages
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command
config unignore Prefix Allows channels or members to use the bot again.

Allows channels or members to use the bot again. If nothing is specified, it unignores the current channel.

Usage
config unignore [entities...]
Aliases unplonk
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
Subcommands (1)
config unignore all Prefix An alias for ignore clear command.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Command Toggles

config channel Prefix Handles the channel-specific permissions.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
Subcommands (2)
config channel disable Prefix Disables a command for this channel.
Usage
config channel disable <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config channel enable Prefix Enables a command for this channel.
Usage
config channel enable <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config disable Prefix Disables a command for the server or a channel.
Usage
config disable [channel] <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config disabled Prefix Shows the disabled commands for the channel given.
Usage
config disabled [channel]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config disabledmessage Prefix Sets what Percy answers (for 10 seconds) when someone runs a command that `config` disabled.

Sets what Percy answers (for 10 seconds) when someone runs a command that `config` disabled. Placeholders: `{command}`, `{channel}`. Without text the reply is removed and Percy stays silent.

Usage
config disabledmessage [text]
Aliases disabledmsg
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config enable Prefix Enables a command the server or a channel.
Usage
config enable [channel] <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config server Prefix Handles the server-specific permissions.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
Subcommands (2)
config server disable Prefix Disables a command for this server.
Usage
config server disable <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
config server enable Prefix Enables a command for this server.
Usage
config server enable <command>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Permissions

config perms Prefix Show every command permission override configured for this server.

Show every command permission override configured for this server. Overrides change *who may run a command* — for both prefix and slash invocations. The bot's own required permissions are always still enforced, and owner-only commands cannot be overridden.

Aliases permissions
You need Manage Guild
Percy needs Read Messages
Link to this command
Subcommands (4)
config perms allow Prefix Add a role to a command's allow-list (they bypass the permission requirement).
Usage
config perms allow <command> <role>
You need Manage Guild
Percy needs Read Messages
Link to this command
config perms reset Prefix Delete a command's override so it reverts to its built-in permission gate.
Usage
config perms reset <command>
Aliases clearremove
You need Manage Guild
Percy needs Read Messages
Link to this command
config perms set Prefix Replace the permission(s) required to run a command in this server.
Usage
config perms set <command> <permissions>
You need Manage Guild
Percy needs Read Messages
Link to this command
config perms unallow Prefix Remove a role from a command's allow-list.
Usage
config perms unallow <command> <role>
Aliases disallowdeny
You need Manage Guild
Percy needs Read Messages
Link to this command

Rules

config explain Prefix Walks the ignore list, disable list, permission override and rules for `member` running `command`.
Usage
config explain <member> <command> [channel]
You need Manage Guild
Percy needs Read Messages
Link to this command
config rule Prefix Rules beat the enable/disable and permission checks: an allow overrides a disable and the default

Rules beat the enable/disable and permission checks: an allow overrides a disable and the default permission gate (never the bot's own permissions), a deny blocks silently. The most specific subject wins (command > parent group > `cog:<Name>` > `*`), then user > role > channel > category > server.

You need Manage Guild
Percy needs Read Messages
Link to this command
Subcommands (3)
config rule allow Prefix Allow `subject` for `target`; quote a multi-word command (`"config perms set"`).
Usage
config rule allow <subject> <target>
You need Manage Guild
Percy needs Read Messages
Link to this command
config rule deny Prefix Deny `subject` for `target`; quote a multi-word command (`"config perms set"`).
Usage
config rule deny <subject> <target>
You need Manage Guild
Percy needs Read Messages
Link to this command
config rule remove Prefix Remove the rule for `subject` and `target`.
Usage
config rule remove <subject> <target>
Aliases resetclear
You need Manage Guild
Percy needs Read Messages
Link to this command
config rules Prefix Lists every command rule of this server.
Usage
config rules [subject]
You need Manage Guild
Percy needs Read Messages
Link to this command

CustomCommands 14

Custom Commands

customcommand Prefix Custom commands answer with one of their responses.

Custom commands answer with one of their responses. Responses may use placeholders: `{param}` (and `.id`/`.name`/`.mention` for members, users, roles and channels), `{author}`, `{channel}`, `{guild}`, `{args}`, `{0}`..`{9}`, `{uses}`, `{choice:a|b|c}` and `{random:1-100}`. Signatures: `<name:type>` required, `[name:type]` optional, `[name:type=default]`, `[name:type...]` takes the rest, `--flag:type`, `--flag`. Types: str, int, number, bool, member, user, role, channel, duration. Run it without a subcommand to open the interactive manager.

Aliases cc
Percy needs Read Messages
Link to this command
Subcommands (9)
customcommand addresponse Prefix Add a response; each use picks one at random.
Usage
customcommand addresponse <name> <response>
You need Manage Guild
Percy needs Read Messages
Link to this command
customcommand create Prefix Create a custom command, e.g. `cc create hug {author} hugs {who}! --args "<who:member>"`.
Usage
customcommand create <name> <response> [flags=Namespace(args=None, perms=None, roles=None, cooldown=None, aliases=None, delete=False, keep=False)]
Aliases add
You need Manage Guild
Percy needs Read Messages
Link to this command
customcommand delete Prefix Delete a custom command.
Usage
customcommand delete <name>
Aliases remove
You need Manage Guild
Percy needs Read Messages
Link to this command
customcommand edit Prefix Change flags, and with a response replace every response with that one.
Usage
customcommand edit <name> [response] [flags=Namespace(args=None, perms=None, roles=None, cooldown=None, aliases=None, delete=False, keep=False)]
You need Manage Guild
Percy needs Read Messages
Link to this command
customcommand info Prefix Shows a custom command's usage, gate, cooldown, owner and use count.
Usage
customcommand info <name>
Percy needs Read Messages
Link to this command
customcommand list Prefix Lists every custom command with its usage.
Percy needs Read Messages
Link to this command
customcommand raw Prefix Shows every response exactly as written, numbered for `cc removeresponse`.
Usage
customcommand raw <name>
Percy needs Read Messages
Link to this command
customcommand removeresponse Prefix Remove response number `index` (see `cc raw`); the last response cannot be removed.
Usage
customcommand removeresponse <name> <index>
You need Manage Guild
Percy needs Read Messages
Link to this command
customcommand rename Prefix Rename a custom command (rules and `config` disables follow the name, so re-add them).
Usage
customcommand rename <name> <new_name>
You need Manage Guild
Percy needs Read Messages
Link to this command

Aliases

alias Prefix An alias expands into a command: `{args}` is everything typed after it and `{0}`..`{9}` single

An alias expands into a command: `{args}` is everything typed after it and `{0}`..`{9}` single words. Without a placeholder the arguments are appended. An alias cannot point to another alias.

Percy needs Read Messages
Link to this command
Subcommands (3)
alias add Prefix Add an alias, e.g. `alias add spamban ban {0} spamming`.
Usage
alias add <name> <expansion>
You need Manage Guild
Percy needs Read Messages
Link to this command
alias list Prefix Lists every alias and what it expands to.
Percy needs Read Messages
Link to this command
alias remove Prefix Remove an alias.
Usage
alias remove <name>
Aliases delete
You need Manage Guild
Percy needs Read Messages
Link to this command

Documentation 2

docs Slash Return a documentation embed for a given symbol.

Return a documentation embed for a given symbol. If no symbol is given, return a list of all available inventories.

Usage
docs <package> [symbol_name]
Aliases d
Percy needs Read Messages
Link to this command
rtfm Slash Gives you a documentation link for a commands.py entity.

Gives you a documentation link for a commands.py entity. Events, objects, and functions are all supported through a cruddy fuzzy algorithm.

Usage
rtfm <package> <symbol_name>
Aliases rtfd
Percy needs Read Messages
Link to this command

Economy 67

Bank

balance Slash Shows your balance
Usage
balance [member]
Aliases bal
Percy needs Read Messages
Link to this command
Subcommands (1)
balance leaderboard Slash Shows the leaderboard of the server: total money, net worth, prestige, daily streak or game profit.
Usage
balance leaderboard ["total"|"networth"|"prestige"|"streak"|"games"=total]
Aliases top
Percy needs Read Messages
Link to this command
deposit Slash Deposits money into your bank. Takes a number, `all`/`max` or `half` of your cash.
Usage
deposit <amount>
Aliases dep
Percy needs Read Messages
Link to this command
transfer Slash Transfers money to another user.
Usage
transfer <member> <amount>
Percy needs Read Messages
Link to this command
withdraw Slash Withdraws money from your bank. Takes a number, `all`/`max` or `half` of your bank.
Usage
withdraw <amount>
Percy needs Read Messages
Link to this command

Rewards

achievements Slash Show a member's achievement badges — earned and still locked.
Usage
achievements [member]
Aliases badges
Percy needs Read Messages
Link to this command
daily Slash Claim your daily reward. Claim on consecutive days to grow your streak bonus.
Example
daily
Percy needs Read Messages
Link to this command
monthly Prefix Claim your monthly reward — the biggest fixed payout, once every 30 days.
Percy needs Read Messages
Link to this command
quests Slash Show today's quests: three rotating tasks with cash rewards, reset daily (UTC).
Aliases quest
Percy needs Read Messages
Link to this command
voteclaim Prefix Claim a coin reward for voting. One claim per vote, per server (see `vote` to vote).
Aliases claimvote
Percy needs Read Messages
Link to this command
weekly Prefix Claim your weekly reward — a bigger payout on a 7-day cooldown.
Percy needs Read Messages
Link to this command

Earning

beg Prefix Beg passers-by for spare change — quick, low stakes, occasionally lucrative.
Percy needs Read Messages
Cooldown1 use per 45s
Link to this command
dig Prefix Grab a shovel and dig — finds range from bottle caps to ancient relics.
Percy needs Read Messages
Cooldown1 use per 90s
Link to this command
fish Prefix Go fishing for a chance at cash — outcomes range from junk to a rare pearl.
Percy needs Read Messages
Cooldown1 use per 1m
Link to this command
hunt Prefix Go hunting — higher payouts and variance than fishing, on a longer cooldown.
Percy needs Read Messages
Cooldown1 use per 90s
Link to this command
job Slash Show your current job, lifetime shifts and progress to the next rung; switch jobs from the menu.
Percy needs Read Messages
Link to this command
Subcommands (3)
job apply Slash Apply for a job you've unlocked with lifetime shifts.
Usage
job apply <name>
Percy needs Read Messages
Link to this command
job list Slash List every job with its pay range and unlock requirement.
Percy needs Read Messages
Link to this command
job quit Slash Quit back down to Freelancer (lifetime shifts are kept).
Percy needs Read Messages
Link to this command
postmemes Prefix Pick one of three meme formats to post.

Pick one of three meme formats to post. Safe formats earn steady change; edgy ones go viral more often but can flop and cost you instead.

Percy needs Read Messages
Cooldown1 use per 1m
Link to this command
work Prefix Work a shift at your current job.

Work a shift at your current job. Everyone starts as a **Freelancer**; shifts accumulate and unlock better jobs on the career ladder — see `job list` and `job apply`. Shifts can roll random events: overtime, tips, or a costly mishap.

Example
work
Percy needs Read Messages
Cooldown1 use per 1h
Link to this command

Items

buy Slash Buy an item from the shop with your cash.
Usage
buy <name> [quantity=1]
Example
buy Lucky Charm 2
Percy needs Read Messages
Link to this command
collection Prefix Your collection book: every fish, hunt and dig drop, or ``???`` until you find it.
Usage
collection [member]
Aliases book
Percy needs Read Messages
Link to this command
gift Slash Gift items you own to another member (no cash involved).
Usage
gift <member> <name> [quantity=1]
Percy needs Read Messages
Link to this command
inventory Slash Your items in one card: filter, open an item, then use, sell or gift it.

Your items in one card: filter, open an item, then use, sell or gift it. Viewing someone else's inventory is read-only.

Usage
inventory [member]
Example
inventory @member
Aliases inv
Percy needs Read Messages
Link to this command
item Slash Open an item's card with its price, effect, stock and the actions you can take.
Usage
item <name>
Example
item Lucky Charm
Percy needs Read Messages
Link to this command
market Prefix Browse open listings, optionally for one item. Sales are taxed 5% (paid by the seller).
Usage
market [item]
Percy needs Read Messages
Link to this command
Subcommands (4)
market buy Prefix Buy some or all of a listing with your cash.
Usage
market buy <listing_id> [quantity]
Percy needs Read Messages
Link to this command
market cancel Prefix Take a listing down; the escrowed items return to your inventory.
Usage
market cancel <listing_id>
Percy needs Read Messages
Link to this command
market mine Prefix Your open listings; cancel one with `market cancel <id>`.
Percy needs Read Messages
Link to this command
market sell Prefix List items on the market. They leave your inventory until bought or cancelled.
Usage
market sell <item> <quantity> <price_each>
Percy needs Read Messages
Link to this command
sell Slash Sell an item from your inventory back for half its price.
Usage
sell <name> [quantity=1]
Example
sell Lucky Charm 1
Percy needs Read Messages
Link to this command
shop Slash Browse the server shop: filter by category, open an item, buy with one click.
Example
shop
Percy needs Read Messages
Link to this command
Subcommands (3)
shop add Slash Add an item to the server shop, optionally with an effect for `use`.

Add an item to the server shop, optionally with an effect for `use`. **Effects:** - **cash**: redeems for `value` cash. - **lootbox**: pays out a random amount around `value` cash. - **role**: grants `role` to the user. - **xp_boost**: +`value`% leveling XP for `duration` minutes. - **loot_boost**: +`value`% fish/hunt payouts for `duration` minutes. - **rob_shield**: blocks rob attempts against the user for `duration` minutes. Emoji, rarity, stock, per-member limit, a required role, an end date (`available_for`), a role to remove on use and a reply message are optional and can be changed later with `shop edit`. `image` is shown on the item's card.

Usage
shop add <name> <price> ["none"|"cash"|"lootbox"|"role"|"xp_boost"|"loot_boost"|"rob_shield"=none] [value] [duration] [role] [emoji] ["common"|"uncommon"|"rare"|"epic"|"legendary"=common] [stock] [limit] [required_role] [available_for] [remove_role] [reply_message] [image] [description]
You need Administrator
Percy needs Read Messages
Link to this command
shop edit Slash Edit a shop item in place — owned copies keep working, unlike remove + add.
Usage
shop edit <name> [new_name] [price] [emoji] ["common"|"uncommon"|"rare"|"epic"|"legendary"] [stock] [limit] [required_role] [available_for] [remove_role] [reply_message] [image] [description]
You need Administrator
Percy needs Read Messages
Link to this command
shop remove Slash Remove an item from the server shop (also clears it from inventories).
Usage
shop remove <name>
Aliases deleterm
You need Administrator
Percy needs Read Messages
Link to this command
trade Slash Open a two-sided trade: both of you add items or cash, both confirm, then it happens at once.
Usage
trade <member>
Example
trade @member
Percy needs Read Messages
Link to this command
use Slash Use (consume) an item you own — what happens depends on the item's effect.

Use (consume) an item you own — what happens depends on the item's effect. Vouchers redeem for cash, lootboxes roll a random payout, role items grant their role, and boost items activate a timed XP or loot multiplier. Only vouchers and lootboxes can be used several at once.

Usage
use <name> [quantity=1]
Example
use Lootbox
Percy needs Manage RolesRead Messages
Link to this command

Progress

cooldowns Prefix Every Economy and Games command with a cooldown, plus your daily, weekly and monthly timers.
Aliases cd
Percy needs Read Messages
Link to this command
multipliers Prefix Every factor behind your earnings: server payout, prestige, boosts and tools.
Usage
multipliers [member]
Aliases multi
Percy needs Read Messages
Link to this command
passive Slash Passive mode: nobody can rob you or heist your bank, and you can't rob or heist anyone.

Passive mode: nobody can rob you or heist your bank, and you can't rob or heist anyone. It can be toggled once every 24 hours, so it can't be flipped on right before someone robs you back.

Usage
passive [enabled]
Percy needs Read Messages
Link to this command
perks Slash View active boosts and perks for yourself or another member.
Usage
perks [member]
Percy needs Read Messages
Link to this command
prestige Prefix Prestige: trade your entire cash & bank balance for a permanent +10% payout bonus.

Prestige: trade your entire cash & bank balance for a permanent +10% payout bonus. Each level requires a higher net worth. The bonus applies to every earning activity (work, fish, hunt, beg, dig, search, daily/weekly/monthly).

Percy needs Read Messages
Link to this command
profile Prefix One card: net worth, rank, prestige, job, pet, achievements, title, best game and daily streak.
Usage
profile [member]
Percy needs Read Messages
Link to this command
Subcommands (1)
profile title Prefix Equip the name of an earned achievement (by name or id) as your profile title.
Usage
profile title [achievement]
Percy needs Read Messages
Link to this command

Economy

economy Slash An interactive overview: balance, job, pet, daily quests, achievements and perks.

An interactive overview: balance, job, pet, daily quests, achievements and perks. Use the select menu to jump between sections; every switch shows live numbers.

Aliases eco
Percy needs Read Messages
Link to this command
Subcommands (3)
economy add-money-role Slash Sets a user's balance
Usage
economy add-money-role <role> <amount> <"bank"|"cash">
You need Administrator
Percy needs Read Messages
Link to this command
economy remove-money Slash Removes from a user's balance
Usage
economy remove-money <member> <amount> <"bank"|"cash">
Aliases rmbalrm-money
You need Administrator
Percy needs Read Messages
Link to this command
economy set-money Slash Sets a user's balance
Usage
economy set-money <member> <amount> <"bank"|"cash">
Aliases setbalset-balance
You need Administrator
Percy needs Read Messages
Link to this command

Economy Config

economy-config Prefix Show the server's economy settings.
Aliases ecoconfig
You need Administrator
Percy needs Read Messages
Link to this command
Subcommands (6)
economy-config bank-cap Prefix Toggle the bank space limit for this server.
Usage
economy-config bank-cap <enabled>
You need Administrator
Percy needs Read Messages
Link to this command
economy-config daily-base Prefix Set the base amount `daily` pays before streak bonuses.
Usage
economy-config daily-base <amount>
You need Administrator
Percy needs Read Messages
Link to this command
economy-config drops Prefix Toggle random chat drops for this server.
Usage
economy-config drops <enabled>
You need Administrator
Percy needs Read Messages
Link to this command
economy-config max-bet Prefix Cap how much members can stake on casino games.
Usage
economy-config max-bet <amount>
You need Administrator
Percy needs Read Messages
Link to this command
economy-config multiplier Prefix Scale every earning activity's payout for this server.
Usage
economy-config multiplier <value>
You need Administrator
Percy needs Read Messages
Link to this command
economy-config rob Prefix Toggle the `rob` command for this server.
Usage
economy-config rob <enabled>
You need Administrator
Percy needs Read Messages
Link to this command

Lottery

lottery Slash Show the current lottery: jackpot, ticket price, time left and your tickets.
Percy needs Read Messages
Link to this command
Subcommands (2)
lottery buy Slash Buy tickets for the active lottery; more tickets mean better odds.
Usage
lottery buy [amount=1]
Percy needs Read Messages
Link to this command
lottery start Slash Start a lottery that draws a weighted-random winner when the timer ends.
Usage
lottery start <duration> <ticket_price>
You need Administrator
Percy needs Read Messages
Link to this command

Pet

pet Slash Show your pet: species, hunger and unclaimed earnings, with Feed and Claim buttons.
Percy needs Read Messages
Link to this command
Subcommands (6)
pet abandon Slash Abandon your pet (permanent — unclaimed earnings are lost).
Percy needs Read Messages
Link to this command
pet adopt Slash Adopt a pet — it earns cash passively as long as you keep it fed.
Usage
pet adopt <"hamster"|"cat"|"dog"|"parrot"|"fox"|"dragon"> [name]
Percy needs Read Messages
Link to this command
pet claim Slash Collect the cash your pet gathered since the last claim.
Percy needs Read Messages
Link to this command
pet feed Slash Feed your pet so it keeps earning at full rate.
Percy needs Read Messages
Link to this command
pet rename Slash Give your pet a new name.
Usage
pet rename <name>
Percy needs Read Messages
Link to this command
pet shop Slash List every adoptable species with cost, earn rate and upkeep.
Percy needs Read Messages
Link to this command

Emoji 7

General

emojipost Prefix Fancy post the emoji lists
Aliases emojilist
Percy needs Read Messages
Cooldown1 use per 15s
Link to this command
randomemoji Prefix Sends a random emoji from the database.
Aliases randemojirandemoterandomemote
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command

Emoji

emoji Slash Emoji management commands.
Aliases emotesemote
Percy needs Read Messages
Link to this command
Subcommands (4)
emoji create Slash Create an emoji for the server under the given name.

Create an emoji for the server under the given name. You must have Manage Emoji permission to use this. The bot must have this permission too.

Usage
emoji create <name> [file] [emoji]
Aliases add
You need Manage Expressions
Percy needs Manage ExpressionsRead Messages
Link to this command
emoji stats Slash Shows you statistics about the emoji usage.
Usage
emoji stats <emoji>
Percy needs Read Messages
Link to this command
emoji stats global Slash Shows you statistics about the global emoji usage.
Aliases all
Percy needs Read Messages
Link to this command
emoji stats server Slash Shows you statistics about the local server emojis in this server.
Aliases guild
Percy needs Read Messages
Link to this command

Games 34

General

games Slash An interactive catalogue of every game — pick one for its rules and your stats.
Aliases arcade
Percy needs Read Messages
Link to this command

Casino

blackjack Slash
Usage
blackjack <bet>
Aliases bj
Percy needs Read Messages
Link to this command
coinflip Slash Call heads or tails. Against the bot it's double-or-nothing; against a member both ante the bet and the winner takes the pot.
Usage
coinflip <bet> ["heads"|"tails"=heads] [opponent]
Aliases cf
Percy needs Read Messages
Link to this command
crash Slash The multiplier climbs every second and a half until it crashes at a hidden point.

The multiplier climbs every second and a half until it crashes at a hidden point. Cash out any time to win `bet x multiplier`; stay on past the crash and the stake is gone.

Usage
crash <bet> [auto]
Percy needs Read Messages
Link to this command
dice Slash Roll two dice and bet on their total — rarer totals pay much more.
Usage
dice <bet> <target>
Percy needs Read Messages
Link to this command
gamble Slash You and Percy each roll a d12. Roll higher to double your bet; a tie or lower loses it.
Usage
gamble <bet>
Aliases bet
Percy needs Read Messages
Link to this command
higherlower Slash Guess whether the next card is higher or lower; cash out before you bust.
Usage
higherlower <bet>
Aliases hl
Percy needs Read Messages
Link to this command
horserace Slash Bet on a horse. When the gates close the race runs and the pool is split among winning bets.
Usage
horserace <bet> <horse>
Aliases hr
Percy needs Add ReactionsRead Messages
Link to this command
keno Prefix Choose up to ten numbers (or give a single count for random picks). Ten of forty numbers are drawn.
Usage
keno <bet> <numbers>
Percy needs Read Messages
Link to this command
mines Slash Flip gems for a rising multiplier and cash out before you hit a mine.
Usage
mines <bet> [mines=3]
Percy needs Read Messages
Link to this command
plinko Prefix Drop a ball down 8, 12 or 16 rows of pegs. Higher risk means bigger edge slots and a duller middle.
Usage
plinko <bet> [rows=12] [risk=medium]
Percy needs Read Messages
Link to this command
poker Slash Play a game of Texas Hold'em Poker.
Usage
poker <stack>
Percy needs Read Messages
Link to this command
roulette Slash Play a game of roulette.

Play a game of roulette. You can bet on a single space or a range of VALID_SPACES.

Usage
roulette <bet> <space>
Percy needs Add ReactionsRead Messages
Link to this command
russianroulette Slash Open a Russian Roulette table; players ante in, take turns, and the last survivor takes the pot.
Usage
russianroulette [ante=100]
Aliases rr
Percy needs Read Messages
Link to this command
scratch Slash Buy a 3x3 scratch card, scratch three tiles and get paid the average of what you uncover.
Usage
scratch <bet>
Percy needs Read Messages
Link to this command
slots Slash Play a game of slots.
Usage
slots <bet>
Aliases slot
Percy needs Read Messages
Link to this command
snakeeyes Slash Roll two dice. A single 1 doubles your bet, snake eyes (both 1s) pays fifteen times.
Usage
snakeeyes <bet>
Aliases se
Percy needs Read Messages
Link to this command
tower Slash Play a round of Tower game.
Usage
tower [bet=100]
Percy needs Read Messages
Link to this command

Crime

crime Prefix Commit a crime for money.

Commit a crime for money. Fail Rate: `60%` Minimum Payout: `250` Maximum Payout: `700` Cooldown: `1 day`

Percy needs Read Messages
Cooldown1 use per 1d
Link to this command
fight Slash Punch, defend or flee in turns until someone drops to 0 HP. With a bet, the winner takes the pot.
Usage
fight <member> [bet=0]
Percy needs Read Messages
Link to this command
heist Slash Open a 60-second crew sign-up for a heist on someone's **bank**.

Open a 60-second crew sign-up for a heist on someone's **bank**. Every extra crew member raises the odds. Success splits a slice of the bank evenly; failure fines every member a slice of their cash.

Usage
heist <member>
Aliases bankrob
Percy needs Read Messages
Cooldown1 use per 2h
Link to this command
rob Slash Rob another Users cash.

Rob another Users cash. You can only rob a user's **cash** balance. Fail Rate: `your total / (their cash + your total)` This has a minimum of 20% and a maximum of 80%. Possible amount to steal: `success rate * their cash` Failing penalty is the same as with command `crime`

Usage
rob <user>
Percy needs Read Messages
Cooldown1 use per 1d
Link to this command
slut Prefix Do some naughty work for cash. (NSFW)

Do some naughty work for cash. (NSFW) Fail Rate: `35%` Minimum Payout: `100` Maximum Payout: `400` Cooldown: `4 hours`

Percy needs Read Messages
Cooldown1 use per 4h
Link to this command

Puzzles & Party

hangman Slash Play hangman with the bot.
Usage
hangman [flags=Namespace(min_length=0, max_length=25, min_unique_letters=0, max_unique_letters=25)]
Percy needs Read Messages
Link to this command
minesweeper Slash Play a Minesweeper Game.
Usage
minesweeper [mines=3]
Aliases ms
Percy needs Read Messages
Link to this command
tictactoe Slash Play a TicTacToe party with another user.
Usage
tictactoe <other>
Aliases ttt
Percy needs Read Messages
Link to this command
trivia Slash Post a trivia question; built-in ones are multiple choice, custom lists are answered by typing.
Usage
trivia [list_name]
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
trivialist Prefix Custom trivia lists. Play one with `trivia <name>`.
Percy needs Read Messages
Link to this command
Subcommands (5)
trivialist all Prefix List this server's custom trivia lists.
Aliases lists
Percy needs Read Messages
Link to this command
trivialist delete Prefix Delete a custom trivia list.
Usage
trivialist delete <name>
You need Manage Guild
Percy needs Read Messages
Link to this command
trivialist leaderboard Prefix The server's top 10 for custom trivia lists.
Percy needs Read Messages
Link to this command
trivialist show Prefix Show the first questions of a list.
Usage
trivialist show <name>
Percy needs Read Messages
Link to this command
trivialist upload Prefix Attach a JSON file: `{"question": ["answer", ...]}` (Red's format) or the built-in shape.
Usage
trivialist upload <name>
You need Manage Guild
Percy needs Read Messages
Link to this command
wordle Slash Play the guild's daily Wordle — guess the 5-letter word in 6 tries (type guesses in chat).
Percy needs Read Messages
Link to this command

Giveaways 4

giveaway Slash Manage giveaways.
Percy needs Read Messages
Link to this command
Subcommands (3)
giveaway create Slash Creates a giveaway.
Usage
giveaway create <when> <prize> [flags=Namespace(role=None, min_account_days=None, min_join_days=None, winners=1, description=None, channel=None)]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
giveaway end Slash Ends a giveaway.
Usage
giveaway end <giveaway_id>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
giveaway quick Slash Create a giveaway by describing it in plain language — the AI fills in the details.

Create a giveaway by describing it in plain language — the AI fills in the details. e.g. "give away a Nitro classic to 2 winners for 1 day". Falls back to `giveaway create` when AI is unavailable.

Usage
giveaway quick <description> [flags=Namespace(role=None, min_account_days=None, min_join_days=None)]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Leveling 14

General

level Slash View yours or someone else's rank card.
Usage
level [member]
Example
level @member
Percy needs Attach FilesManage RolesRead Messages
Link to this command
Subcommands (3)
level card Slash Pick your rank card's theme, accent colour, progress bar and font with a live preview.
Percy needs Read Messages
Link to this command
level leaderboard Slash View the Top 10 users of the server.
Aliases top
Percy needs Read Messages
Link to this command
level set Slash Set a users experience/level.
Usage
level set <target> [flags=Namespace(xp=None, level=None)]
You need Administrator
Percy needs Read Messages
Link to this command

Settings

level config Slash Leveling Configuration Commands.
Percy needs Read Messages
Link to this command
Subcommands (9)
level config channel Slash Set the level up channel for the server.

Set the level up channel for the server. Leave `channel` empty to don't send level up messages, use `dm` for DMs and `channel` for the current channel or provide a channel. Note: To set the channel to dm or current channel, please use the text command version of this command.

Usage
level config channel [channel]
You need Manage Guild
Percy needs Read Messages
Link to this command
level config delete-after-leave Slash Toggle deleting user data after leave.
Usage
level config delete-after-leave <delete>
You need Manage Guild
Percy needs Read Messages
Link to this command
level config ignore Slash Set ignorable entities for the leveling system.

Set ignorable entities for the leveling system. You can ignore roles, channels and users from the leveling system.

Usage
level config ignore [entities]...
You need Manage Guild
Percy needs Read Messages
Link to this command
level config message Slash Set the level up message for the server.

Set the level up message for the server. Use {level} for the level and {user} for the user.

Usage
level config message <message>
You need Manage Guild
Percy needs Read Messages
Link to this command
level config multiplier Slash Set the multiplier roles for the server.
You need Manage Guild
Percy needs Read Messages
Link to this command
level config roles Slash Set the level up message for the server.
You need Manage Guild
Percy needs Read Messages
Link to this command
level config toggle Slash Toggle leveling on or off.
Usage
level config toggle <enabled>
You need Manage Guild
Percy needs Read Messages
Link to this command
level config unignore Slash Unset ignored entities for the leveling system.
Usage
level config unignore [entities]...
You need Manage Guild
Percy needs Read Messages
Link to this command
level config voice Slash Toggle voice-activity XP.

Toggle voice-activity XP. Members earn XP each minute they are active (not alone, AFK or deafened) in a voice channel. The same blacklists and level-roles as message XP apply.

Usage
level config voice <enabled> [xp_per_minute]
You need Manage Guild
Percy needs Read Messages
Link to this command

Misc 56

Info

appinfo Prefix Displays information about a discord application.
Usage
appinfo <app_id>
Percy needs Read Messages
Link to this command
avatar Prefix Shows a user's enlarged avatar (if possible).
Usage
avatar [user]
Aliases av
Percy needs Read Messages
Link to this command
charinfo Prefix Shows you information on up to 50 unicode characters.
Usage
charinfo <characters>
Percy needs Read Messages
Link to this command
dashboard Prefix Shows the dashboard of the bot.
Percy needs Read Messages
Link to this command
featureinfo Prefix Shows the features of a guild.
Usage
featureinfo [guild_id]
Aliases fi
Percy needs Read Messages
Link to this command
feedback Prefix Sends feedback about the bot to the owner.

Sends feedback about the bot to the owner. The Owner will communicate with you via PM to inform you about the status of your request if needed. You can only request feedback once a minute.

Usage
feedback <content>
Percy needs Read Messages
Cooldown1 use per 1m
Link to this command
permissions Prefix Shows permissions for a member or the bot in a specific channel.
Aliases permspermsfor
Percy needs Read Messages
Link to this command
Subcommands (2)
permissions bot Prefix Shows the bots permissions in a specific channel.

Shows the bots permissions in a specific channel. If no channel is given then it uses the current one. This is a good way of checking if the bot has the permissions needed to execute the commands it wants to execute.

Usage
permissions bot [channel]
Percy needs Read Messages
Link to this command
permissions user Prefix Shows a member's permissions in a specific channel.

Shows a member's permissions in a specific channel. If no channel is given then it uses the current one. You cannot use this in private messages. If no member is given then the info returned will be yours.

Usage
permissions user [member] [channel]
Percy needs Read Messages
Link to this command
ping Prefix Pong! Sends detailed information about the bot's latency.
Aliases ponglatency
Percy needs Read Messages
Cooldown2 uses per 3s
Link to this command
raw Prefix Shows information about the raw API response.
Usage
raw <message> [to_json=False]
Percy needs Read Messages
Link to this command
serverinfo Prefix Shows info about the current or a specified server.
Usage
serverinfo [guild_id]
Aliases si
Percy needs Read Messages
Link to this command
snowflake Prefix Get Discord snowflake creation time.
Usage
snowflake [snowflakes...]
Aliases snfsnflsf
Percy needs Read Messages
Link to this command
vote Prefix Vote for the bot on a bot list to earn a renewable XP boost.

Vote for the bot on a bot list to earn a renewable XP boost. Each vote grants a **+10% XP boost for 12 hours** that applies in every server you share with me. Voting again refreshes the timer — you can vote every 12 hours on each site.

Aliases v
Percy needs Read Messages
Cooldown1 use per 3s
Link to this command

Tools

ask Prefix Ask the AI assistant a question.

Ask the AI assistant a question. Reply to the assistant's answer to keep the conversation going — Percy remembers the whole thread, no need to type the command again.

Usage
ask <prompt>
Example
ask how do I set up leveling?
Aliases aichat
Percy needs Read Messages
Cooldown1 use per 12s
Link to this command
chart Prefix Render a single-series chart and share a link to it.

Render a single-series chart and share a link to it. Example: ``?chart bar Quarterly Sales | Q1:120, Q2:180, Q3:90, Q4:210``

Usage
chart <spec>
Aliases renderchart
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
codeimage Prefix Render code to a syntax-highlighted image and share a link to it.

Render code to a syntax-highlighted image and share a link to it. Wrap the code in a fenced ```` ```lang ```` block to pick the highlighter; otherwise it renders as plain text.

Usage
codeimage <code>
Aliases codeshotrendercode
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
color Prefix Shows information about a color.
Usage
color <color>
Percy needs Read Messages
Link to this command
mdpdf Prefix Render Markdown to a PDF and attach it.
Usage
mdpdf <markdown>
Aliases markdownpdfmd2pdf
Percy needs Read Messages
Cooldown1 use per 15s
Link to this command
paste Prefix Create a hosted paste, viewable at ``/p/<id>`` (highlighted) and ``.txt`` (raw).
Usage
paste <content>
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
preview Prefix Fetch a URL's Open Graph / link-preview metadata.
Usage
preview <url>
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
qr Prefix Render ``data`` as a QR code image.
Usage
qr <data>
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
scan Prefix Scan an attached file for malware.

Scan an attached file for malware. Attach a file (or reply to a message with one). Nothing is stored — only the file's SHA-256 (never its contents) is sent to VirusTotal.

Percy needs Read Messages
Cooldown1 use per 15s
Link to this command
screenshot Prefix Render a web page to a PNG via a headless browser.
Usage
screenshot <url>
Percy needs Read Messages
Cooldown1 use per 15s
Link to this command
shorten Prefix Create a short link (``r.klappstuhl.me/<code>``) for a URL.
Usage
shorten <url> [alias]
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command
solved Slash Marks a thread as solved.
Percy needs Manage ThreadsRead Messages
Cooldown1 use per 5s
Link to this command
translate Prefix Translate text into another language.

Translate text into another language. The source language is detected automatically. Examples: `?translate de Hello, how are you?` · `?translate spanish good morning`

Usage
translate <language> <text>
Aliases tr
Percy needs Read Messages
Link to this command

Fun

fact Prefix Shows you a random fact.
Percy needs Read Messages
Link to this command
meme Prefix Shows you a random reddit meme.
Percy needs Read Messages
Link to this command
quote Prefix Quotes a message by a user.
Usage
quote [user] [message]
Aliases q
Percy needs Attach FilesRead Messages
Link to this command
urban Prefix Searches urban dictionary.
Usage
urban <word>
Percy needs Read Messages
Link to this command

Server Setup

prefix Prefix Manages the server's custom prefixes.
Percy needs Read Messages
Link to this command
Subcommands (3)
prefix add Prefix Adds a prefix to the list of custom prefixes.

Adds a prefix to the list of custom prefixes. **Multi-word prefixes must be quoted.**

Usage
prefix add [prefixes...]
Aliases appendcreate+updatenew
You need Manage Guild
Percy needs Read Messages
Link to this command
prefix remove Prefix Removes a prefix from the list of custom prefixes.

Removes a prefix from the list of custom prefixes. You can use this to remove prefixes from the default set as well.

Usage
prefix remove [prefixes...]
Aliases deletedelrm-
You need Manage Guild
Percy needs Read Messages
Link to this command
prefix reset Prefix Removes all custom prefixes.

Removes all custom prefixes. **After this, the bot will listen to only mention prefixes.**

Aliases clearwipepurge
You need Manage Guild
Percy needs Read Messages
Link to this command
statcounter Slash List the server's stat counters.
Aliases counter
Percy needs Read Messages
Link to this command
Subcommands (2)
statcounter create Slash Create a locked voice channel that shows a live server statistic.
Usage
statcounter create <"members"|"humans"|"bots"|"online"|"boosts"|"roles"|"channels"> [template={name}: {count}]
You need Administrator
Percy needs Manage ChannelsRead Messages
Link to this command
statcounter remove Slash Remove a stat counter and delete its voice channel.
Usage
statcounter remove <channel>
Aliases deleterm
You need Administrator
Percy needs Manage ChannelsRead Messages
Link to this command
temp Slash Get an overview of the Use of the TempChannels.
Percy needs Read Messages
Link to this command
Subcommands (4)
temp list Slash List of current temporary channels.
Percy needs Read Messages
Link to this command
temp purge Slash Remove all temporary channels.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
temp remove Slash Remove an existing temp channel.
Usage
temp remove <channel_id>
You need Manage Channels
Percy needs Manage ChannelsManage RolesMove MembersRead Messages
Link to this command
temp set Slash Sets the channel where to create a temporary channel.

Sets the channel where to create a temporary channel. **Format Variables:** - **%name**: The name of the user. - **%display_name**: The name of the user. - **%channel**: The name of the voice hub. - **%guild**: The name of the guild.

Usage
temp set <channel> [_format=⏳ | %name]
You need Manage Channels
Percy needs Manage ChannelsManage RolesMove MembersRead Messages
Link to this command

Discord Status

discord-status Prefix Shows the current Discord Status.
Aliases dstatus
Percy needs Read Messages
Link to this command
Subcommands (3)
discord-status release Prefix Posts the latest incident to the subscribed channel if it is not already there.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
discord-status subscribe Prefix Subscribes to Discord Status updates.
Usage
discord-status subscribe <channel>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
discord-status unsubscribe Prefix Unsubscribes from Discord Status updates.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Image

image Prefix Image tools. Every subcommand takes a member (their avatar), an image

Image tools. Every subcommand takes a member (their avatar), an image URL, an attachment, or a replied-to image — defaulting to your own avatar.

Aliases img
Percy needs Read Messages
Link to this command
Subcommands (8)
image blur Prefix
Usage
image blur [target]
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
image convert Prefix Transcode an image to a different raster format.
Usage
image convert <to> [target]
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
image deepfry Prefix
Usage
image deepfry [target]
Aliases fry
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
image grayscale Prefix
Usage
image grayscale [target]
Aliases greyscalegraygrey
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
image info Prefix Show an image's dimensions, format, and size without storing it.
Usage
image info [target]
Aliases metadata
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command
image invert Prefix
Usage
image invert [target]
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command
image palette Prefix Extract an image's dominant colours (great for embed accents).
Usage
image palette [target]
Aliases colorscolours
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command
image pixelate Prefix
Usage
image pixelate [target]
Aliases pixel
Percy needs Read Messages
Cooldown1 use per 8s
Link to this command

ModLog 18

Warnings

clearwarns Prefix Mark all of a member's warns inactive.
Usage
clearwarns <member>
You need Kick Members
Percy needs Read Messages
Link to this command
pardon Prefix Mark one warn inactive.
Usage
pardon <index>
You need Kick Members
Percy needs Read Messages
Link to this command
warn Slash Warn a member and log a case.
Usage
warn <member> [reason] [flags=Namespace(points=None)]
Example
warn @member spamming in #general
You need Kick Members
Percy needs Read Messages
Link to this command
warnings Prefix List a member's warnings (pardoned and expired ones included).
Usage
warnings <user>
You need Manage Messages
Percy needs Read Messages
Link to this command
warnreason Prefix List reason presets.
You need Manage Guild
Percy needs Read Messages
Link to this command
Subcommands (2)
warnreason add Prefix Add or replace a preset.
Usage
warnreason add <name> <points> <description>
You need Manage Guild
Percy needs Read Messages
Link to this command
warnreason remove Prefix Remove a preset.
Usage
warnreason remove <name>
You need Manage Guild
Percy needs Read Messages
Link to this command

Cases

case Prefix Show one moderation case by number.
Usage
case <index>
You need Manage Messages
Percy needs Read Messages
Link to this command
cases Prefix List a member's moderation cases.
Usage
cases <user>
Aliases historymodlogs
You need Manage Messages
Percy needs Read Messages
Link to this command
delcase Prefix Delete a moderation case (and its modlog post).
Usage
delcase <index>
Aliases deletecase
You need Ban Members
Percy needs Read Messages
Link to this command
reason Prefix Edit a case's reason (and its modlog post).
Usage
reason <index> <reason>
You need Manage Messages
Percy needs Read Messages
Link to this command

Settings

modlog Prefix Show the current modlog channel.
Percy needs Read Messages
Link to this command
Subcommands (2)
modlog disable Prefix Disable modlog channel posting.
You need Manage Guild
Percy needs Read Messages
Link to this command
modlog set Prefix Set the modlog channel.
Usage
modlog set <channel>
You need Manage Guild
Percy needs Read Messages
Link to this command
warnpolicy Prefix Show the warn policy.
You need Manage Guild
Percy needs Read Messages
Link to this command
Subcommands (3)
warnpolicy expiry Prefix Set warn expiry.
Usage
warnpolicy expiry <days>
You need Manage Guild
Percy needs Read Messages
Link to this command
warnpolicy remove Prefix Remove a rule.
Usage
warnpolicy remove <count>
You need Manage Guild
Percy needs Read Messages
Link to this command
warnpolicy set Prefix Add or replace the rule for a warn count.
Usage
warnpolicy set <count> <action> [duration]
You need Manage Guild
Percy needs Read Messages
Link to this command

Moderation 42

General

purge Slash Removes messages that meet a criteria.

Removes messages that meet a criteria. This command uses a syntax similar to Discord's search bar. The messages are only deleted if all options are met unless the `--require` flag is passed to override the behaviour. When the command is done doing its work, you will get a message detailing which users got removed and how many messages got removed.

Usage
purge [search] [flags=Namespace(user=None, contains=None, prefix=None, suffix=None, after=None, before=None, delete_pinned=False, bot=False, webhooks=False, embeds=False, files=False, emoji=False, reactions=False, require='all')]
Aliases clear
You need Manage Messages
Percy needs Manage MessagesRead Messages
Link to this command
slowmode Slash Applies slowmode to this channel
Usage
slowmode <duration>
Aliases sm
You need Manage Channels
Percy needs Manage ChannelsRead Messages
Link to this command

Bans & Kicks

ban Prefix Bans a member from the server.

Bans a member from the server. You can also ban from ID to ban regardless of whether they're in the server or not.

Usage
ban <member> [reason]
You need Ban Members
Percy needs Ban MembersRead Messages
Link to this command
kick Slash Kicks a member from the server.
Usage
kick <member> [reason]
You need Kick Members
Percy needs Kick MembersRead Messages
Link to this command
multiban Prefix Bans multiple members from the server.

Bans multiple members from the server. This only works through banning via ID.

Usage
multiban [members]... [reason]
You need Ban MembersKick Members
Percy needs Ban MembersRead Messages
Link to this command
softban Slash Soft bans a member from the server.

Soft bans a member from the server. A softban is basically banning the member from the server but then unbanning the member as well. This allows you to essentially kick the member while removing their messages.

Usage
softban <member> [reason]
You need Kick Members
Percy needs Ban MembersRead Messages
Link to this command
tempban Slash Temporarily bans a member for the specified duration.

Temporarily bans a member for the specified duration. The duration can be a short time form e.g., 30d or a more human duration such as "until thursday at 3PM" or a more concrete time such as "2024-12-31". **You need to quote the duration if it contains spaces.** Note that times are in UTC unless the timezone is specified using the 'timezone set' command. ### Important If you want to ban a member by ID, consider using the text version of this command. The App Commands version of this command does not support banning by ID.

Usage
tempban <duration> <member> [reason]
You need Ban Members
Percy needs Ban MembersRead Messages
Link to this command
unban Slash Unbans a member from the server.

Unbans a member from the server. You can pass either the ID of the banned member or the Name#Discrim combination/Global Name of the member. Typically, the ID is easiest to use.

Usage
unban <member> [reason]
You need Ban Members
Percy needs Ban MembersRead Messages
Link to this command

Mutes

mute Slash Mutes members indefinitely using the configured mute role.

Mutes members indefinitely using the configured mute role. The bot must have Manage Roles permission and be above the muted role in the hierarchy. To use this command, you need to be higher than the mute role in the hierarchy. Members who are already muted are skipped; use `tempmute` for a timed mute.

Usage
mute [members]... [reason]
Example
mute @member
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command
muterole Prefix Opens the mute role configuration menu.

Opens the mute role configuration menu. A single dashboard to bind an existing role, create a fresh one, sync its channel permission overwrites, or unbind it — all from one place.

You need Manage ChannelsManage MessagesManage Roles
Percy needs Manage ChannelsManage MessagesManage RolesRead Messages
Link to this command
selfmute Slash Temporarily mutes yourself for the specified duration.

Temporarily mutes yourself for the specified duration. The duration must be in a short time form e.g., 4h. Can only mute yourself for a maximum of 24 hours and a minimum of 5 minutes. **Don't ask a moderator to unmute you.**

Usage
selfmute <duration>
Percy needs Manage RolesRead Messages
Link to this command
tempmute Slash Temporarily mutes a member for the specified duration.

Temporarily mutes a member for the specified duration. The duration can be a short time form e.g., 30d or a more human duration such as "until thursday at 3PM" or a more concrete time such as "2024-12-31". **You need to quote the duration if it contains spaces.** Note that times are in UTC unless a timezone is specified using the 'timezone set' command. ### Important If you want to ban a member by ID, consider using the text version of this command. The App Commands version of this command does not support banning by ID.

Usage
tempmute <duration> <member> [reason]
You need Kick MembersManage MessagesManage Roles
Percy needs Manage RolesRead Messages
Link to this command
unmute Slash Unmutes members using the configured mute role.

Unmutes members using the configured mute role. Works for normal mutes, tempmutes and self-mutes, cancelling any pending expiry timer so the member is not unmuted twice. You cannot remove your own self-mute -- a moderator has to do it for you. The bot must have Manage Roles permission and be above the muted role in the hierarchy, and you need to be higher than the mute role in the hierarchy.

Usage
unmute [members]... [reason]
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command

Restrictions

channelmute Prefix Denies sending messages, reactions and speaking for one member in one channel.
Usage
channelmute <member> [channel] [duration] [reason]
You need Manage ChannelsManage Roles
Percy needs Manage RolesRead Messages
Link to this command
channelunmute Prefix Lifts a channel mute.
Usage
channelunmute <member> [channel]
You need Manage ChannelsManage Roles
Percy needs Manage RolesRead Messages
Link to this command
nick Prefix Changes or resets a member's nickname.
Usage
nick <member> [nickname]
You need Manage Nicknames
Percy needs Manage NicknamesRead Messages
Link to this command
nickfreeze Prefix Locks a member's nickname.
Usage
nickfreeze <member> <nickname>
You need Manage Nicknames
Percy needs Manage NicknamesRead Messages
Link to this command
nickunfreeze Prefix Unlocks a frozen nickname.
Usage
nickunfreeze <member>
You need Manage Nicknames
Percy needs Read Messages
Link to this command
stickyrole Prefix Sticky roles come back when a member rejoins the server or someone takes them off.
Aliases forcerole
You need Manage Roles
Percy needs Read Messages
Link to this command
Subcommands (3)
stickyrole add Prefix Gives the role and re-applies it whenever the member rejoins or loses it.
Usage
stickyrole add <member> <role>
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command
stickyrole list Prefix Lists the sticky roles.
Usage
stickyrole list [member]
You need Manage Roles
Percy needs Read Messages
Link to this command
stickyrole remove Prefix Stops re-applying the role; the member keeps it until it is removed.
Usage
stickyrole remove <member> <role>
You need Manage Roles
Percy needs Read Messages
Link to this command
voiceban Prefix Gives the member a `Voice Banned` role (created on first use) and disconnects them.

Gives the member a `Voice Banned` role (created on first use) and disconnects them. Re-applied if they rejoin the server.

Usage
voiceban <member> [duration] [reason]
You need Manage Roles
Percy needs Manage RolesMove MembersRead Messages
Link to this command
voicekick Prefix Disconnects a member from voice.
Usage
voicekick <member> [reason]
You need Move Members
Percy needs Move MembersRead Messages
Link to this command
voiceunban Prefix Lifts a voice ban.
Usage
voiceunban <member> [reason]
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command

Lockdown

lockdown Slash Locks down channels by denying the default role to send messages or connect to voice channels.
Usage
lockdown [channels]...
You need Ban MembersManage Messages
Percy needs Manage RolesRead Messages
Cooldown1 use per 30s
Link to this command
Subcommands (2)
lockdown end Slash Ends all set lockdowns.

Ends all set lockdowns. To use this command, you must have Manage Roles and Ban Members permissions. The bot must also have Manage Members permissions.

You need Ban MembersManage Messages
Percy needs Manage RolesRead Messages
Link to this command
lockdown for Slash Locks down specific channels for a specified amount of time.
Usage
lockdown for <duration> [channels]...
You need Ban MembersManage Messages
Percy needs Manage RolesRead Messages
Cooldown1 use per 30s
Link to this command

Moderation

moderation Slash Show current Bot-Automatic-Moderation behavior on the server.
Aliases mod
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
Subcommands (13)
moderation alerts Slash Toggles alert message logging on the server.

Toggles alert message logging on the server. The bot must have the ability to create webhooks in the given channel.

Usage
moderation alerts <channel>
You need Ban MembersManage Messages
Percy needs Manage WebhooksRead Messages
Link to this command
moderation auditlog Slash Toggles audit text log on the server.

Toggles audit text log on the server. Audit Log sends a message to the log channel whenever a certain event is triggered.

Usage
moderation auditlog <channel>
You need Ban MembersManage Messages
Percy needs Manage WebhooksRead Messages
Link to this command
moderation auditlog alter Slash Configures the audit log events.

Configures the audit log events. You can set the Events you want to get notified about via the Audit Log Channel.

Usage
moderation auditlog alter <flag> <value>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation disable Slash Disables Moderation on the server.

Disables Moderation on the server. ## Settings - **all**: to disable everything - **alerts**: to disable alert messages - **raid**: to disable raid protection - **mentions**: to disable mention spam protection - **auditlog**: to disable audit logging - **sentinel**: to disable sentinel If not given then it defaults to 'all'.

Usage
moderation disable ["all"|"raid"|"mentions"|"auditlog"|"alerts"|"sentinel"=all]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation ignore Slash Adds roles, members, or channels to the ignore list for Moderation auto-bans.
Usage
moderation ignore [entities]...
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation ignored Slash List all the channels, roles, and members that are in the Moderation ignore list.
Percy needs Read Messages
Link to this command
moderation mentions Slash Enables auto-banning accounts that spam more than 'count' mentions.

Enables auto-banning accounts that spam more than 'count' mentions. To use this command, you must have the Ban Members permission. The count must be between 3 and 100. A member is banned when one message, or all their messages within 15 seconds, mention more than 'count' users. Note: Only user mentions count; role mentions, bots and the author themself are not counted.

Usage
moderation mentions <count>
You need Ban MembersManage Messages
Percy needs Ban MembersRead Messages
Link to this command
moderation raid Slash Toggles raid protection on the server.

Toggles raid protection on the server. Raid protection automatically bans members that spam messages in your server.

Usage
moderation raid [enabled]
You need Ban MembersManage Messages
Percy needs Ban MembersRead Messages
Link to this command
moderation sentinel Slash Enables and shows the sentinel settings menu for the server.

Enables and shows the sentinel settings menu for the server. Sentinel automatically assigns a role to members who join to prevent them from participating in the server until they verify themselves by pressing a button.

You need Ban MembersManage Messages
Percy needs Ban MembersKick MembersManage RolesRead Messages
Link to this command
moderation settings Slash Shows the moderation switches: DM on action, required reasons, reinvite on unban, default ban cleanup.
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation settings bandays Slash Sets the default message cleanup of `ban`.
Usage
moderation settings bandays <days>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation settings toggle Slash Turns `dm`, `reason` or `reinvite` on or off.
Usage
moderation settings toggle <"dm"|"reason"|"reinvite"> [enabled]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
moderation unignore Slash Remove roles, members, or channels from the ignore list for Moderation auto-bans.
Usage
moderation unignore [entities]...
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Music 51

General

connect Slash Connect me to a voice-channel.
Usage
connect [channel]
Percy needs ConnectRead MessagesSpeak
Link to this command
leave Slash Disconnect me from a voice-channel.
Percy needs Read Messages
Link to this command

Playback

back Slash Plays the previous Track.
Percy needs Read Messages
Link to this command
forceskip Slash Skip the playing song.
Percy needs Read Messages
Link to this command
loop Slash Sets a loop mode for the plugins.
Usage
loop <"normal"|"track"|"queue">
Percy needs Read Messages
Link to this command
lyrics Slash Show lyrics for a song.

Show lyrics for a song. Invoked as the **/lyrics** slash command while a track is playing, this follows the song with live, auto-scrolling synced lyrics. The prefix command (and any plain text search) always returns static lyrics.

Usage
lyrics [song]
Percy needs Read Messages
Link to this command
play Slash Play Music in a voice channel by searching for a track/playlist.
Usage
play <query> [flags=Namespace(source='yt', force=False, recommendations=False)]
Example
play never gonna give you up
Percy needs ConnectRead MessagesSpeak
Link to this command
playsearch Slash Adds a track/playlist to the queue by choosing from a variety of examples.
Usage
playsearch <query> [flags=Namespace(source='yt', force=False, recommendations=False)]
Percy needs ConnectRead MessagesSpeak
Link to this command
seek Slash Seek to a specific position in the tack.
Usage
seek [position]
Percy needs Read Messages
Link to this command
shuffle Slash Sets the shuffle mode for the plugins.
Usage
shuffle <mode>
Percy needs Read Messages
Link to this command
stop Slash Clears the queue and stop the current plugins.
Percy needs Read Messages
Link to this command
toggle Slash Pause the current playing track.
Aliases pauseresume
Percy needs Read Messages
Link to this command
vibe Slash Describe a vibe in plain language and let the AI pick what to play (and a filter).

Describe a vibe in plain language and let the AI pick what to play (and a filter). The AI turns your description into a concrete search and, when you imply it, an audio filter (bassboost / nightcore / 8d / lowpass). Falls back to `play` if unavailable.

Usage
vibe <description> [flags=Namespace(source='yt', force=False, recommendations=False)]
Percy needs ConnectRead MessagesSpeak
Link to this command
volume Slash Set the volume for the plugins.
Usage
volume [amount]
Percy needs Read Messages
Link to this command

Queue

cleanupleft Prefix Removes all songs from users that are not in the voice channel.
Percy needs Read Messages
Link to this command
queue Slash Display the active queue, plus recently played history on a separate page.
Percy needs Read Messages
Link to this command
Subcommands (3)
queue jump Slash Jump to a track in the Queue.

Jump to a track in the Queue. Note: The position is the 1-based spot in the upcoming queue (1 = the next track).

Usage
queue jump <position>
Aliases jump-to
Percy needs Read Messages
Link to this command
queue move Slash Move a track to another spot in the queue. DJs and members with Manage Server only.
Usage
queue move <position> <to>
Aliases move-track
Percy needs Read Messages
Link to this command
queue remove Slash Remove a track from the queue. DJs and members with Manage Server, or whoever queued it.
Usage
queue remove <position>
Aliases remove-track
Percy needs Read Messages
Link to this command

Settings

dj Slash Manage the DJ Role.
Percy needs Read Messages
Link to this command
Subcommands (2)
dj add Slash Adds the DJ Role with which you have extended control rights to a member.

Adds the DJ Role with which you have extended control rights to a member. Note: The DJ role is used to give extended control rights to a member. If no DJ role exists, the bot will create a new one.

Usage
dj add <member>
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command
dj remove Slash Removes the DJ Role with which you have extended control rights from a member.
Usage
dj remove <member>
You need Manage Roles
Percy needs Manage RolesRead Messages
Link to this command
music Slash Opens the music configuration dashboard.
You need Manage Channels
Percy needs Manage ChannelsManage MessagesRead Messages
Link to this command
Subcommands (2)
music 247 Slash Configure a 24/7 always-on player.

Configure a 24/7 always-on player. The player reconnects automatically after a disconnect or bot restart and keeps the chosen source running forever: - **radio** — an endless internet-radio / live-stream URL - **playlist** — a playlist/album link or search, looped endlessly - **autoplay** — seed a track and let recommendations keep it going

Usage
music 247 <"radio"|"playlist"|"autoplay"|"off"> [source]
You need Manage Channels
Percy needs Read Messages
Link to this command
music radios Slash List the curated radio presets usable with `music 247 radio <name>`.
Percy needs Read Messages
Link to this command

Discover

discover Slash Find music: recently played, picks for you, artists and albums.
Percy needs Read Messages
Link to this command
Subcommands (4)
discover album Slash The tracks of an album, single or playlist link, ready to queue.
Usage
discover album <link>
Percy needs Read Messages
Link to this command
discover artist Slash An artist's top tracks, found on Spotify or YouTube Music.
Usage
discover artist <name>
Percy needs Read Messages
Link to this command
discover foryou Slash Songs by the artists you play most (your last 30 days), skipping ones you already play.
Percy needs Read Messages
Link to this command
discover history Slash What this server played lately, newest first, with who queued it.
Percy needs Read Messages
Link to this command

Filter

filter Slash Display all active filters and the current equalizer, or use a subcommand to modify them.
Percy needs Read Messages
Link to this command
Subcommands (6)
filter 8d Slash Apply an 8D Filter to create a 3D effect.
Percy needs Read Messages
Link to this command
filter bassboost Slash Apply a bassboost filter for the current track.
Percy needs Read Messages
Link to this command
filter equalizer Slash Set a custom Equalizer for the current Track.

Set a custom Equalizer for the current Track. Notes ----- The preset paremeter will be given priority, if provided.

Usage
filter equalizer [band] [gain]
Percy needs Read Messages
Link to this command
filter lowpass Slash Apply a Lowpass Filter to the current Track.
Usage
filter lowpass <smoothing>
Percy needs Read Messages
Link to this command
filter nightcore Slash Apply a Nightcore Filter to the current track.
Percy needs Read Messages
Link to this command
filter reset Slash Reset all active filters.
Percy needs Read Messages
Link to this command

Listen Together

listen-together Slash Start a listen-together activity with an user.

Start a listen-together activity with an user. `Note:` Only supported for Spotify Music.

Usage
listen-together <member>
Percy needs ConnectRead MessagesSpeak
Link to this command
Subcommands (1)
listen-together stop Slash Stops the current listen-together activity.
Percy needs Read Messages
Link to this command

Playlist

playlist Slash Manage your playlist.
Aliases pl
Percy needs Read Messages
Link to this command
Subcommands (11)
playlist add Slash Adds the current playing track or a track via a direct-url to your playlist.
Usage
playlist add <name_or_id> [query]
Percy needs Read Messages
Link to this command
playlist clear Slash Clear all Items in a playlist.
Usage
playlist clear <name_or_id>
Aliases purgeclean
Percy needs Read Messages
Link to this command
playlist cover Slash Set a playlist's cover from an image link, or reset it. Upload images in the web player.
Usage
playlist cover <name_or_id> [link]
Percy needs Read Messages
Link to this command
playlist create Slash Create a new playlist.
Usage
playlist create <name>
Percy needs Read Messages
Link to this command
playlist delete Slash Delete a playlist.
Usage
playlist delete <name_or_id>
Aliases del
Percy needs Read Messages
Link to this command
playlist export Slash Export one of your playlists as a JSON file.
Usage
playlist export <name_or_id>
Percy needs Read Messages
Link to this command
playlist import Slash Create a playlist from an exported JSON file.
Usage
playlist import <file (upload a file)> [name]
Percy needs Read Messages
Link to this command
playlist play Slash Add the songs from you playlist to the plugins queue and play them.
Usage
playlist play <name_or_id>
Percy needs Read Messages
Link to this command
playlist remove Slash Remove a track from your playlist.
Usage
playlist remove <name_or_id> <track_id>
Aliases rm
Percy needs Read Messages
Link to this command
playlist rename Slash Rename one of your playlists (Liked Songs keeps its name).
Usage
playlist rename <name_or_id> <new_name>
Percy needs Read Messages
Link to this command
playlist show Slash Display all your playlists and tracks.
Percy needs Read Messages
Link to this command

Notifications 5

General

report Slash Usage: `report @member spamming invites`. Only moderators see it.
Usage
report <member> <reason>
Percy needs Read Messages
Cooldown1 use per 10s
Link to this command

Request

request Slash Ask for a moderation action you can't run yourself.
Percy needs Read Messages
Link to this command
Subcommands (3)
request cancel Slash
Usage
request cancel <request_id>
Percy needs Read Messages
Link to this command
request create Slash Usage: `request create timeout @member 1h spamming links` or `request create ban @member reason`.
Usage
request create <"kick"|"ban"|"softban"|"warn"|"mute"|"unmute"|"timeout"|"untimeout"> <member> [duration] <reason>
Percy needs Read Messages
Cooldown1 use per 30s
Link to this command
request list Slash
Percy needs Read Messages
Link to this command

Polls 11

polls Slash Group command for managing polls.
Aliases poll
Percy needs Read Messages
Link to this command
Subcommands (10)
polls ask Slash Create a poll by describing it in plain language — the AI fills in the details.

Create a poll by describing it in plain language — the AI fills in the details. e.g. "ask whether we should host a movie night, options yes / no / maybe, for 2 days". Falls back to `polls create` when AI is unavailable.

Usage
polls ask <description>
You need Ban MembersManage Messages
Percy needs Manage MessagesManage ThreadsRead Messages
Link to this command
polls config Slash Shows/Changes the current configuration for polls.
Usage
polls config [flags=Namespace(channel=None, reason_channel=None, ping_role=None, reset=False)]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
polls create Slash Creates a poll with customizable settings.
Usage
polls create <when> <question> <flags>
You need Ban MembersManage Messages
Percy needs Manage MessagesManage ThreadsRead Messages
Link to this command
polls debug Slash Refactor all existing Polls in this guild and reattach the views.
Usage
polls debug <poll_id>
You need Ban MembersManage Messages
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command
polls delete Slash Deletes a poll question.
Usage
polls delete <poll_id>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
polls edit Slash Edits a poll question.

Edits a poll question. You can also remove the following fields by typing `--clear` as the value to change. Possible Parameters to remove: - Color - Description - Any not None Field - Thread

Usage
polls edit <poll_id> [flags=Namespace(question=None, description=None, thread_question=None, image=None, image_url=None, color=None, opt_1=None, opt_2=None, opt_3=None, opt_4=None, opt_5=None, opt_6=None, opt_7=None, opt_8=None)]
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command
polls end Slash Ends a poll.
Usage
polls end <poll_id>
You need Ban MembersManage Messages
Percy needs Manage ThreadsRead Messages
Link to this command
polls history Slash Shows the vote history of a user for polls.
Usage
polls history [member]
Percy needs Read Messages
Link to this command
polls voters Slash Lists each option's voters (needs Manage Messages).
Usage
polls voters <poll_id>
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command

Releases 3

subscribe Slash Follow something and get a DM when it has news.
Usage
subscribe <subject> ["releases"|"news"|"both"=releases]
Percy needs Read Messages
Link to this command
subscriptions Slash List your subscriptions.
Aliases subs
Percy needs Read Messages
Link to this command
unsubscribe Slash Unfollow something you subscribed to.
Usage
unsubscribe <subject>
Percy needs Read Messages
Link to this command

Reminder 4

reminder Slash Reminds you of something after a certain amount of timetools.

Reminds you of something after a certain amount of timetools. The input can be any direct date (e.g. YYYY-MM-DD) or a human-readable offset. Times are in UTC unless a timezone is specified using the "timezone set" command.

Usage
reminder <prompt> [flags=Namespace(timezone=None, dm=False, every=None, count=None, share=None)]
Example
next thursday at 3pm do something funny
Aliases timerremindmeremind
Percy needs Read Messages
Link to this command
Subcommands (3)
reminder delete Slash Deletes a reminder by its ID.

Deletes a reminder by its ID. To get a reminder ID, use the reminder list command. You must own the reminder to delete it, obviously.

Usage
reminder delete <reminder_id>
Aliases delremoverm
Percy needs Read Messages
Link to this command
reminder list Slash Shows your currently running reminders.
Percy needs Read Messages
Link to this command
reminder purge Slash Purges all reminders you have set.
Percy needs Read Messages
Link to this command

RoleMenus 6

rolemenu Slash List the server's role menus.
Aliases rolemenusreactionroles
Percy needs Manage RolesRead Messages
Link to this command
Subcommands (5)
rolemenu add Slash Add a role to an existing menu.
Usage
rolemenu add <menu_id> <role> [emoji] [label]
You need Manage Guild
Percy needs Read Messages
Link to this command
rolemenu create Slash Create a role menu (initially empty — add roles with `rolemenu add`).
Usage
rolemenu create <channel> <title> [description]
You need Manage Guild
Percy needs Read Messages
Link to this command
rolemenu delete Slash Delete a role menu entirely.
Usage
rolemenu delete <menu_id>
You need Manage Guild
Percy needs Read Messages
Link to this command
rolemenu remove Slash Remove a role from a menu.
Usage
rolemenu remove <menu_id> <role>
Aliases delete-rolerm
You need Manage Guild
Percy needs Read Messages
Link to this command
rolemenu unique Slash Toggle radio-style (single-choice) behaviour for a menu.
Usage
rolemenu unique <menu_id> <enabled>
You need Manage Guild
Percy needs Read Messages
Link to this command

Snekbox 2

eval Prefix Run Python code and get the results.

Run Python code and get the results. This command supports multiple lines of code, including formatted code blocks. Code can be re-evaluated interactively using the buttons on the result panel. The starting working directory `/home`, is a writeable temporary file system. Files created, excluding names with leading underscores, will be uploaded in the response. If multiple codeblocks are in a message, all of them will be joined and evaluated, ignoring the text outside them. We've done our best to make this sandboxed, but do let us know if you manage to find an issue with it!

Usage
eval <code> [flags=Namespace(version='3.12')]
Aliases e
Percy needs Read Messages
Link to this command
timeit Prefix Profile Python Code to find execution time.

Profile Python Code to find execution time. This command supports multiple lines of code, including code wrapped inside a formatted code block. Code can be re-evaluated interactively using the buttons on the result panel. If multiple formatted codeblocks are provided, the first one will be the setup code, which will not be timed. The remaining codeblocks will be joined together and timed. We've done our best to make this sandboxed, but do let us know if you manage to find an issue with it!

Usage
timeit <code> [flags=Namespace(version='3.12')]
Aliases ti
Percy needs Read Messages
Link to this command

Starboard 13

General

starboard Slash Show the current starboard configuration.
Percy needs Read Messages
Link to this command
Subcommands (2)
starboard stats Slash Show starboard statistics for the server or a specific member.
Usage
starboard stats [member]
Percy needs Read Messages
Link to this command
starboard top Slash Show the server's most-starred messages.
Percy needs Read Messages
Link to this command

Settings

starboard channel Slash Set the starboard destination channel.
Usage
starboard channel <channel>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard config Slash Open the interactive configuration panel.
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard emoji Slash Set the star emoji.
Usage
starboard emoji <emoji>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard ignore Slash Ignore a channel.
Usage
starboard ignore <channel>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard maxage Slash Set the maximum age a message can be to reach the starboard.
Usage
starboard maxage <hours>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard nsfw Slash Toggle whether NSFW-channel messages may reach the starboard.
Usage
starboard nsfw <allowed>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard selfstar Slash Toggle self-starring.
Usage
starboard selfstar <allowed>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard threshold Slash Set the star threshold.
Usage
starboard threshold <amount>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard toggle Slash Enable or disable the starboard.
Usage
starboard toggle <enabled>
You need Manage Guild
Percy needs Read Messages
Link to this command
starboard unignore Slash Stop ignoring a channel.
Usage
starboard unignore <channel>
You need Manage Guild
Percy needs Read Messages
Link to this command

Stats 16

Bot

about Prefix Tells you information about the bot itself.
Percy needs Read Messages
Link to this command
uptime Prefix Tells you how long the bot has been up for.
Percy needs Read Messages
Link to this command

Users

avatarhistory Prefix Shows the avatar history of a user.
Usage
avatarhistory [member]
Aliases avhy
Percy needs Read Messages
Link to this command
lastseen Prefix
Usage
lastseen [member]
Aliases ls
Percy needs Read Messages
Link to this command
names Prefix
Usage
names [member]
Aliases ns
Percy needs Read Messages
Link to this command
presence Prefix
Usage
presence [member]
Aliases ps
Percy needs Read Messages
Link to this command
userinfo Prefix
Usage
userinfo [member]
Aliases ui
Percy needs Read Messages
Link to this command

Command Usage

stats Prefix Tells you command usage stats for the server or a member.
Usage
stats [member]
Percy needs Read Messages
Cooldown1 use per 5s
Link to this command
Subcommands (6)
stats activity Prefix Daily command volume chart for the server.
Usage
stats activity [days=30]
Percy needs Read Messages
Link to this command
stats failures Prefix Failure-rate ranking: failed vs total invocations per command.
Usage
stats failures [days=30]
Percy needs Read Messages
Link to this command
stats global Prefix Global all time command statistics.
Percy needs Read Messages
Link to this command
stats heatmap Prefix Per-member activity heatmap.
Usage
stats heatmap [member] [days=90]
Percy needs Read Messages
Link to this command
stats hours Prefix Command usage by hour of day.
Usage
stats hours [days=30]
Percy needs Read Messages
Link to this command
stats today Prefix Global command statistics for the day.
Percy needs Read Messages
Link to this command

Games

stats gameboard Prefix Server-wide game leaderboard, ranked by total wins (ties broken by win-rate).
Usage
stats gameboard [game]
Aliases gametop
Percy needs Read Messages
Link to this command
stats games Prefix Shows a member's per-game record across all casino & party games.
Usage
stats games [member]
Aliases game
Percy needs Read Messages
Link to this command

Tags 17

General

tag Slash Retrieves a tag from the server.

Retrieves a tag from the server. If the tag is an alias, the original tag will be retrieved instead.

Usage
tag <name_or_id>
Percy needs Read Messages
Link to this command

Browse

tag find Slash Find the tag that best answers a plain-language question — even if you don't know its name.

Find the tag that best answers a plain-language question — even if you don't know its name. Unlike `tag search` (which matches the name), this matches the *intent* of your question to a tag. Falls back to `tag search` when AI is unavailable.

Usage
tag find <query>
Percy needs Read Messages
Link to this command
tag info Slash Shows you Information about a Tag.
Usage
tag info <name_or_id>
Percy needs Read Messages
Link to this command
tag list Slash Shows a list of Tags owned by yourself or a given member.
Usage
tag list [flags=Namespace(member=None, sort='name', to_text=False)]
Percy needs Read Messages
Link to this command
tag raw Slash This displays you the raw content of a tag.
Usage
tag raw <name_or_id>
Aliases content
Percy needs Read Messages
Link to this command
tag stats Slash Shows Tag Statistics about the Server or a Member.
Usage
tag stats [member]
Percy needs Read Messages
Link to this command

Manage

tag alias Slash Assign an alias to an existing tag of yours.

Assign an alias to an existing tag of yours. `Note:` You have to be the owner of the Tag. One the Original Tag gets deleted, all the assigned aliases will be deleted too. Every alias can be only assigned to one Tag. If you want to edit an alias, you have to delete it and create a new one.

Usage
tag alias <new_alias> <original_tag>
Example
new-alias original-tag
Percy needs Read Messages
Link to this command
tag create Slash Creates a new Tag owned by yourself in this server.

Creates a new Tag owned by yourself in this server. The tag name must be between 1 and 100 characters long. The tag content must be less than 2000 characters long. `Note:` You can create aliases for Tags using `tags alias <alias-name> <original-name>`

Usage
tag create <name> <content>
Example
new-tag This is the content of the tag.
Aliases add
Percy needs Read Messages
Link to this command
tag delete Slash Removes a Tag by ID owned by yourself.

Removes a Tag by ID owned by yourself. Your Tags can also be removed by Moderators if they have the `MANAGE MESSAGES` permission. `Note:` This will also remove all aliases of the tag.

Usage
tag delete <name_or_id>
Aliases remove
Percy needs Read Messages
Link to this command
tag edit Slash Edit the content or name of a Tag.

Edit the content or name of a Tag. `Note:` If you don't pass a content, you will be prompted to edit the tag in a modal. This may be useful for larger contents. You can only edit the name of the tag in within the modal.

Usage
tag edit <name_or_id> [use_embed] [content]
Percy needs Read Messages
Link to this command
tag export Slash Exports all your tags/server tags to a csv file.
Usage
tag export ["server"|"personal"=personal]
Percy needs Read Messages
Cooldown1 use per 30s
Link to this command
tag make Slash Interactively create a Tag owned by yourself in this server.

Interactively create a Tag owned by yourself in this server. Note: May be useful for larger contents / bigger names.

Percy needs Read Messages
Link to this command
tag purge Slash Bulk remove all Tags and assigned Aliases of a given User.
Usage
tag purge <member>
You need Ban MembersManage Messages
Percy needs Read Messages
Link to this command

Ownership

tag claim Slash Claim a tag by yourself if the User is not in this server anymore or the tag has no owner.
Usage
tag claim <name_or_id>
Percy needs Read Messages
Link to this command
tag transfer Slash Transfer a tag owned by you to another member.
Usage
tag transfer <member> <name_or_id>
Percy needs Read Messages
Link to this command
Subcommands (1)
tag transfer cancel Slash Cancel a pending transfer; the tag returns to you.
Usage
tag transfer cancel <name_or_id>
Percy needs Read Messages
Link to this command

User Settings 7

settings Slash Shows your settings.
Percy needs Read Messages
Link to this command
Subcommands (6)
settings remove-personal-data Slash Permanently delete your stored personal data.

Permanently delete your stored personal data. This removes your stored presence history, avatar history and name/nickname history. This action cannot be undone.

Percy needs Read Messages
Link to this command
settings request-data Slash Request a copy of your stored personal data (a GDPR-style data export).

Request a copy of your stored personal data (a GDPR-style data export). DMs you a JSON file with **all** the data Percy has stored about you: your settings, consent-tracked history (presence, name/nickname, avatar), leveling, economy, game stats, content you created (tags, notes, reminders, playlists, giveaways, poll answers, highlights), linked accounts, vote rewards and the moderation cases that reference you.

Percy needs Read Messages
Link to this command
settings timezone Slash Shows/Manages the timezone of a user.
Usage
settings timezone [user=<you>]
Aliases tz
Percy needs Read Messages
Link to this command
settings timezone info Slash Retrieves info about a timezone.
Usage
settings timezone info <tz>
Percy needs Read Messages
Link to this command
settings timezone reset Slash This is useful if you want to stop using timezone-aware features or if you want to reset a misconfigured timezone.
Percy needs Read Messages
Link to this command
settings timezone set Slash Sets your timezone.

Sets your timezone. This is used to convert times to your local timezone when using the reminder command and other miscellaneous commands such as tempblock, tempmute, etc.

Usage
settings timezone set <tz>
Percy needs Read Messages
Link to this command

Command Syntax & Flags Guide

Percy supports both slash commands (/command) and prefix commands (e.g. !command). Slash commands use Discord's built-in parameter UI — you just fill in the fields. The syntax notation below applies to prefix commands, where you type arguments directly.


Argument Notation

Tip: Never type the brackets themselves — they only indicate the argument type.

NotationMeaningExample
<argument>Required — the command fails without it<user>
[argument]Optional — omit to use the default behaviour[reason]
<A|B>Choice — pick exactly one<ban|kick>
<argument...>Greedy — consumes the rest of the input<reason...>
<"argument">Exact — case-sensitive, type it verbatim<"CONFIRM">
<argument="X">Default — uses X when omitted<limit="10">
[--flag]Boolean flag — see below[--silent]
[--name <arg>]Valued flag — see below[--reason <text>]

Flags

Flags are optional, POSIX-style parameters prefixed with -- (long form) or - (short form). They can appear anywhere in the command — order does not matter.

Boolean flags

A flag shown as [--flag] is a toggle: absent = off, present = on.

!warn @User Spamming --silent

Here --silent is True; the rest before it is the reason.

Valued flags

A flag shown as [--name <arg>] requires a value immediately after it. The value runs until the next flag or end of input.

!search discord bots --limit 5 --sort date

--limit receives 5, --sort receives date.

Short flags

Single-letter shortcuts use one dash. You can chain boolean short flags together — only the last one in a chain may take a value.

!command -sf            (equivalent to --s --f, both boolean)
!command -sf "value"    (equivalent to --s --f "value", -f takes the value)

Putting it together

Given a command signature like:

!ban <user> [reason...] [--silent] [--duration <time>]

You might type:

!ban @User Repeated rule violations --silent --duration 7d
  • @User fills the required <user> parameter
  • Repeated rule violations fills the greedy [reason...]
  • --silent enables the silent flag
  • --duration 7d passes 7d to the duration flag