All Commands

Display user's achievements and progress (prettier embed)

Economy commands.


**eco iteminfo**
View detailed information about a legendary item.


**eco deposit**
Deposit money from your pocket to your bank. Use 'all' to deposit everything.


**eco weekly**
Claim your weekly reward.


**eco interest**
View and claim your daily bank interest.

If you have not yet claimed today’s interest, you can claim it immediately.
Otherwise, this shows your interest rate, current balance, time until next payout,
and the amount you’ll earn.


**eco claimvote**
Claim your voting rewards, including random items with rarity-based chances.


**eco gamble**
Gambling commands.


**eco profile**
View detailed user profile with economy stats, badges, achievements, and inventory highlights.


**eco balance**
Check your or another user's balance.


**eco monthly**
Claim your monthly reward.


**eco daily**
Claim your daily reward.


**eco shop**
Browse the shop with filters for category, rarity, and price range.

Parameters
----------
category: Filter by item category
rarity: Filter by item rarity (common, uncommon, rare, epic, legendary)
min_price: Minimum price filter
max_price: Maximum price filter


**eco sell**
Sell an item from your inventory.

Use 'all' or 'all ' to bulk-sell items.


**eco effects**
List your active legendary‐item effects with expiry times and remaining charges.


**eco gather**
Unified command for digging, fishing, and hunting.

Usage: gather [quantity=1]


**eco interest-notifications**
Manage your interest notification preferences.

Usage:
- `interest-notifications` - Check current status
- `interest-notifications true` - Enable notifications
- `interest-notifications false` - Disable notifications


**eco use**
Use an item from your inventory to trigger its legendary effect.


**eco bankrob**
Rob someone's bank with a dramatic quick-time event sequence.


**eco buy**
Buy one or more items from the shop.

Specify quantities with `Nx Item Name`, e.g. `3x Sword, 2 Potion, Shield`.


**eco beg**
Beg for coins from Akiko.


**eco leaderboard**
Display wealth leaderboard (daily/weekly/monthly/all-time)


**eco repair**
Repair an item in your inventory


**eco achievements**
Display your achievements and progress.


**eco work**
Work commands. Specify hours (max 24) to work.


**eco inventory**
View your or another user's inventory.


**eco withdraw**
Withdraw money from your bank to your pocket. Use 'all' to withdraw everything.

Check your or another user's balance.

Rob someone's bank with a dramatic quick-time event sequence.

Claim your voting rewards, including random items with rarity-based chances.

Deposit money from your pocket to your bank. Use 'all' to deposit everything.

List your active legendary‐item effects with expiry times and remaining charges.

View and claim your daily bank interest.

If you have not yet claimed today’s interest, you can claim it immediately.
Otherwise, this shows your interest rate, current balance, time until next payout,
and the amount you’ll earn.

Manage your interest notification preferences.

Usage:
- `interest-notifications` - Check current status
- `interest-notifications true` - Enable notifications
- `interest-notifications false` - Disable notifications

Display wealth leaderboard (daily/weekly/monthly/all-time)

View detailed user profile with economy stats, badges, achievements, and inventory highlights.

Repair an item in your inventory

Withdraw money from your bank to your pocket. Use 'all' to withdraw everything.

A bunch of fun actions to mess around with


**actions joke**



**actions hug**
Hug people


**actions smug**
Look smug


**actions nitro**
Free nitro!!


**actions dap**
Aye dap me up


**actions kill**
Kill someone


**actions pat**
Pat people


**actions why**
why


**actions owoify**
Owoify any message


**actions fact**
Get a random fact


**actions insult**
Get a random insult


**actions slap**
Slap people


**actions kiss**
Kiss people


**actions wasted**



**actions eightball**
Ask 8ball


**actions comment**

Aye dap me up

Ask 8ball

Get a random fact

Hug people

Get a random insult

Kill someone

Kiss people

Free nitro!!

Owoify any message

Pat people

Slap people

Look smug

why

Generate a pie chart of message activity in a channel.

Creates a visual pie chart showing which users sent the most messages
in the specified channel over the last N messages.

Parameters
----------
ctx : Context
The invocation context.
channel : discord.TextChannel | None, optional
The channel to analyze. Defaults to the current channel.
messages : int, optional
Number of messages to analyze (default 5000, min 5).

Notes
-----
Has a 5-minute server-wide cooldown.
Requires message tracking opt-in.

Post a random conversation starter to revive chat.

Sends a random question or topic to help spark conversation
in an inactive channel.

Parameters
----------
ctx : Context
The invocation context.

Enlarge custom emojis to full size.

Extracts custom Discord emojis from a message or reply and posts
them as full-size PNG/GIF files.

Parameters
----------
ctx : Context
The invocation context.
message : str, optional
Message containing custom emojis. Can also be a reply to a message.

Examples
--------
;;enlarge :custom_emoji:
(reply to a message with emojis) ;;enlarge

Simulate hacking a user's account with edgy humor and fake data

Bonk-o-meter 9000

Scientific(ly questionable) hotness analysis

Rainbow spectrum evaluation

Image generation commands


**image achievement**
Generate a Minecraft achievement image

Parameters
-----------
args: Any
The arguments to use for the achievement. See `!help help image achievement` for more info.

Arguments:
`text/t:` The text to use for the achievement
`icon/i:` The icon to use for the achievement

Example:
`;;image achievement t: Touch grass icon: 1`


**image supreme**
Generate a supreme image.

Parameters
-----------
texts: str
The text to use.

Example:
`;;image supreme Akiko`


**image challenge**
Generate a Minecraft challenge image

Parameters
-----------
args: Any
The arguments to use for the challenge. See `!help help image challenge` for more info.

Arguments:
`text/t:` The text to use for the challenge
`icon/i:` The icon to use for the challenge

Example:
`;;image challenge t: Touch grass icon: 1`


**image phub**
Generate a phub comment image.

Parameters
-----------
texts: str
The text to use. Split by space.

Example:
`;;image phub Aki ko`


**image drake**
Generate a drake meme image.

Parameters
-----------
texts: str
The text to use. Split by space.

Example:
`;;img drake dyno Akiko`


**image calling**
Generate a calling meme image.

Parameters
-----------
texts: str
The text to use.

Example:
`;;image calling I'm a cool `


**image captcha**
Generate a captcha image.

Parameters
-----------
texts: str
The text to use.

Example:
`!gen captcha Are you a robot?`

Generate a Minecraft achievement image

Parameters
-----------
args: Any
The arguments to use for the achievement. See `!help help image achievement` for more info.

Arguments:
`text/t:` The text to use for the achievement
`icon/i:` The icon to use for the achievement

Example:
`;;image achievement t: Touch grass icon: 1`

Generate a calling meme image.

Parameters
-----------
texts: str
The text to use.

Example:
`;;image calling I'm a cool `

Generate a captcha image.

Parameters
-----------
texts: str
The text to use.

Example:
`!gen captcha Are you a robot?`

Generate a Minecraft challenge image

Parameters
-----------
args: Any
The arguments to use for the challenge. See `!help help image challenge` for more info.

Arguments:
`text/t:` The text to use for the challenge
`icon/i:` The icon to use for the challenge

Example:
`;;image challenge t: Touch grass icon: 1`

Generate a drake meme image.

Parameters
-----------
texts: str
The text to use. Split by space.

Example:
`;;img drake dyno Akiko`

Generate a phub comment image.

Parameters
-----------
texts: str
The text to use. Split by space.

Example:
`;;image phub Aki ko`

Generate a supreme image.

Parameters
-----------
texts: str
The text to use.

Example:
`;;image supreme Akiko`

Generate a random 'pp size' for a user.

A fun command that generates a random size visualization.
This is purely for entertainment purposes.

Parameters
----------
ctx : Context
The invocation context.
user : discord.Member | discord.User, optional
The user to generate a size for. Defaults to the command invoker.

Press F to pay respects

Parameters
----------
thing: UserOrString
The thing to pay respects to. Can be a user or a string.

Rates anything with brutal honesty

Generate a pie chart of server-wide message activity.

Creates a visual pie chart showing message activity across all channels
the user has access to.

Parameters
----------
ctx : Context
The invocation context.
messages : int, optional
Number of messages per channel to analyze (default 1000, min 5).

Notes
-----
Has a 1-hour server-wide cooldown.
Requires message tracking opt-in.
Analyzes all readable text channels in the server.

Combine two entities with love.

Creates ship names by combining two users or two things together.

Parameters
----------
ctx : Context
The invocation context.

Subcommands
-----------
user : Ship two Discord users
thing : Ship two objects/items


**ship user**
Create a ship name from two users' names.

Generates a combined name from two users and calculates a compatibility score.

Parameters
----------
ctx : Context
The invocation context.
user1 : discord.Member | discord.User
First user to ship.
user2 : discord.Member | discord.User
Second user to ship.


**ship thing**
🔀 Merge two objects into a creative combination

🔀 Merge two objects into a creative combination

Create a ship name from two users' names.

Generates a combined name from two users and calculates a compatibility score.

Parameters
----------
ctx : Context
The invocation context.
user1 : discord.Member | discord.User
First user to ship.
user2 : discord.Member | discord.User
Second user to ship.

Detects e-boy/girl radiation levels

Among Us certified suspiciousness rating

Set your AFK status.

Parameters
----------
reason : Optional[str]
The reason why you're going AFK, by default "AFK".

Get anyones avatar within Discord.
Args:
ephemeral (optional): make the command visible to you or others. Defaults to False.

Get the current banner image

Set up a counting channel


**channel-counting edit**
Edit an existing counting channel.

Parameters
----------
goal: int
The new goal number to reach.
multiply_goal_by: int
The new number to multiply the goal by when it is reached, by default 2.
allow_continues_count: bool
Allow the same user to count multiple times in a row, by default False.
allow_bots: bool
Allow bots to count in the channel (exluding me), by default False.
delete_when_wrong: bool
Delete the message when the number is wrong, by default False.
reset_count_when_wrong: bool
Reset the count when the number is wrong, by default False.
current_count: int
The current number in the counting channel. This is intended to fix situations where the count is off.
Please note that this does not change the goal, but rather the current count.


**channel-counting reset**
Reset a counter channel. This is unreversible!


**channel-counting info**
Get information about the counting channel


**channel-counting remove**
Remove the counting channel


**channel-counting set**
Setup a counting channel.

Parameters
----------
channel: discord.TextChannel | discord.Thread
The channel to set as the counting channel.
goal: int
The goal number to reach.
multiply_goal_by: int
The number to multiply the goal by when it is reached, by default 2.
allow_continues_count: bool
Allow the same user to count multiple times in a row, by default False.
allow_bots: bool
Allow bots to count in the channel (exluding me), by default False.
delete_when_wrong: bool
Delete the message when the number is wrong, by default False.
reset_count_when_wrong: bool
Reset the count when the number is wrong, by default False.

Edit an existing counting channel.

Parameters
----------
goal: int
The new goal number to reach.
multiply_goal_by: int
The new number to multiply the goal by when it is reached, by default 2.
allow_continues_count: bool
Allow the same user to count multiple times in a row, by default False.
allow_bots: bool
Allow bots to count in the channel (exluding me), by default False.
delete_when_wrong: bool
Delete the message when the number is wrong, by default False.
reset_count_when_wrong: bool
Reset the count when the number is wrong, by default False.
current_count: int
The current number in the counting channel. This is intended to fix situations where the count is off.
Please note that this does not change the goal, but rather the current count.

Get information about the counting channel

Remove the counting channel

Reset a counter channel. This is unreversible!

Setup a counting channel.

Parameters
----------
channel: discord.TextChannel | discord.Thread
The channel to set as the counting channel.
goal: int
The goal number to reach.
multiply_goal_by: int
The number to multiply the goal by when it is reached, by default 2.
allow_continues_count: bool
Allow the same user to count multiple times in a row, by default False.
allow_bots: bool
Allow bots to count in the channel (exluding me), by default False.
delete_when_wrong: bool
Delete the message when the number is wrong, by default False.
reset_count_when_wrong: bool
Reset the count when the number is wrong, by default False.

Allows users to give themselves a color

Run `/color list` to see all the colors you can give yourself.

Parameters
-----------
color: Optional[str]
The color to give yourself, if you don't specify a color, your color will be removed.
Choose `random` to get a random color.


**color list**
Tells you all the colors you can give yourself.

`/color me` to give yourself a color role.
Mods can use `/color create-all` to create all the color roles.


**color stats**
Shows how many users have each color role.

`/color me` to give yourself a color role.
`/color list` will show all the color roles I made and which users can have.
And mods can use:
`/color remove-all` to remove all the color roles I made.


**color toggle**
Opt in/out of color roles for your server. (Disable/Enable color role creation)


**color me**
Give yourself a color

Tells you all the colors you can give yourself.

`/color me` to give yourself a color role.
Mods can use `/color create-all` to create all the color roles.

Give yourself a color

Shows how many users have each color role.

`/color me` to give yourself a color role.
`/color list` will show all the color roles I made and which users can have.
And mods can use:
`/color remove-all` to remove all the color roles I made.

Opt in/out of color roles for your server. (Disable/Enable color role creation)

Delete all unused color roles in the server.

Fetch or wipe all of your user data from the database.

Displays a view with options to export your data as JSON or wipe it completely.

Parameters
----------
ctx : Context
The invocation context.

Notes
-----
Data export includes all stored information about the user.
Wiping data is irreversible.

Snipe the last edited message.

Provide a link to the first message in current or provided channel.

Generates a picture for a given color code

Parameters
----------
color_code : str, optional
hex color code, by default None

Get the current server icon

Check when a user joined the current server.

Lists all available emojis in a server, perfect for an emoji channel

Commands to setup logging for various events.


**logging info**
Get information about the logging channels.

Parameters
----------
event_name: str | None
The name of the event to filter by.
channel: discord.TextChannel | None
The channel to filter by.
enabled: bool | None
The state of the event to filter by.


**logging config**
Configure logging for a specific event.

Parameters
----------
event_name: str
The name of the event.
channel: discord.TextChannel
The channel to log the event to.


**logging enable**
enable logging for a specific event.

Parameters
----------
event_name: str
The name of the event.


**logging disable**
Disable logging for a specific event.

Parameters
----------
event_name: str
The name of the event.


**logging config-group**
Configure logging for a whole event group at once.

Parameters
----------
group_name: str
The key of the EVENT_GROUPS dict (e.g. 'member', 'channel', etc.)
channel: discord.TextChannel
The channel to log *all* those events to.


**logging disable-all**
Disable logging for all events. With confirmation.

Configure logging for a specific event.

Parameters
----------
event_name: str
The name of the event.
channel: discord.TextChannel
The channel to log the event to.

Configure logging for a whole event group at once.

Parameters
----------
group_name: str
The key of the EVENT_GROUPS dict (e.g. 'member', 'channel', etc.)
channel: discord.TextChannel
The channel to log *all* those events to.

Disable logging for a specific event.

Parameters
----------
event_name: str
The name of the event.

Disable logging for all events. With confirmation.

enable logging for a specific event.

Parameters
----------
event_name: str
The name of the event.

Get information about the logging channels.

Parameters
----------
event_name: str | None
The name of the event to filter by.
channel: discord.TextChannel | None
The channel to filter by.
enabled: bool | None
The state of the event to filter by.

Mass give a role to all users in the server. Can specify bots only with bots=True.

Mass removes a role from all users or only bots in the server.

Check which mods are in the current guild

Get the last 5 editsnipe messages.

Get up to 5 recently deleted messages.

Remove all color roles that I have made from `/color create-all`.

Get information about a role

Get all roles in current server

Check info about current server

Snipe deleted messages from the channel.

Tag related commands


**tag list**
Lists all tags in the server


**tag create**
Create a tag

Parameters
----------
tag_name : str
The name of the tag

tag_content : str
The tag's content, what you want it to return


**tag raw**
Returns a tag without markdown

Parameters
----------
tag_name : str
Tag name you want to return without markdown


**tag info**
Provides information about a tag

Parameters
----------
tag_name : str
The tag name you want to return information about


**tag show**
Show a tag

Parameters
----------
tag_name : str, optional
The name of the tag to show, by default None


**tag edit**
Edit a tag that you own

Parameters
----------
tag_name : str
The name of the tag that you want to edit

tag_content : str
The new content of the tag


**tag claim**
Claim a tag

Parameters
----------
tag_name : str, optional
The tag you want to claim, by default None


**tag search**
Search for a tag, you can provide partial names and a list of possibilities will be returned

Parameters
----------
tag_name : str
The name of the tag you want to find


**tag delete**
Delete a tag that you own

Parameters
----------
tag_name : str
The name of the tag that you want to delete

Claim a tag

Parameters
----------
tag_name : str, optional
The tag you want to claim, by default None

Create a tag

Parameters
----------
tag_name : str
The name of the tag

tag_content : str
The tag's content, what you want it to return

Delete a tag that you own

Parameters
----------
tag_name : str
The name of the tag that you want to delete

Edit a tag that you own

Parameters
----------
tag_name : str
The name of the tag that you want to edit

tag_content : str
The new content of the tag

Provides information about a tag

Parameters
----------
tag_name : str
The tag name you want to return information about

Lists all tags in the server

Returns a tag without markdown

Parameters
----------
tag_name : str
Tag name you want to return without markdown

Search for a tag, you can provide partial names and a list of possibilities will be returned

Parameters
----------
tag_name : str
The name of the tag you want to find

Show a tag

Parameters
----------
tag_name : str, optional
The name of the tag to show, by default None

Translates messages to English using Google Translate

Gather information about a user (v2 UI layout).

Manage your personal watchlist.

Store and manage links to shows, movies, or other content you want to track.

Parameters
----------
ctx : Context
The invocation context.

Subcommands
-----------
add : Add a new show to the watchlist
list : Display all shows in the watchlist
remove : Remove shows from the watchlist


**watchlist add**
Add a show to your watchlist.

Parameters
----------
ctx : Context
The invocation context.
show_name : str
Name of the show to add.
show_link : str
Valid URL link to the show.


**watchlist remove**
Remove shows from your watchlist.

Parameters
----------
ctx : Context
The invocation context.
show_names : str
Comma-separated list of show names to remove.

Examples
--------
;;watchlist remove Show Name 1, Show Name 2
/watchlist remove Show Name


**watchlist list**
List all shows in your watchlist.

Displays an embed with all saved shows and their links.

Parameters
----------
ctx : Context
The invocation context.

Add a show to your watchlist.

Parameters
----------
ctx : Context
The invocation context.
show_name : str
Name of the show to add.
show_link : str
Valid URL link to the show.

List all shows in your watchlist.

Displays an embed with all saved shows and their links.

Parameters
----------
ctx : Context
The invocation context.

Remove shows from your watchlist.

Parameters
----------
ctx : Context
The invocation context.
show_names : str
Comma-separated list of show names to remove.

Examples
--------
;;watchlist remove Show Name 1, Show Name 2
/watchlist remove Show Name

Query Wolfram|Alpha with optional modes, flags, conversational context, or image input.

📌 Flags
--------
**--geo=LAT,LON** Ground the query to a specific location (e.g. "40.11,-88.28")
**--ip=IP_ADDRESS** Let Wolfram infer locale and location from IP
**--units={metric,imperial}** Force units regardless of locale
**--raw** Dump the full JSON response
**--simple** Use the Simple API for image-based pods
**--full** Use the Full Results API (pods as JSON)
**--spoken** Use the Spoken Results API (plain text)
**--width=PIXELS** Set image/table width
**--maxwidth=PIXELS** Set maximum width
**--plotwidth=PIXELS** Width for plots
**--timeout=SECONDS** Time limit for spoken API
**history** Show your conversation history

📸 Image Upload
-------------
If you attach an image, its URL will be sent directly to Wolfram for analysis.

🎙️ Examples
------------
/wolfram --spoken What’s the square root of 144
/wolfram --geo=40.11,-88.28 sunrise tomorrow
/wolfram --full --units=imperial melting point of iron
/wolfram [attach an image url]
/wolfram history

Ask Akiko a question

Generate an AI image from your prompt

Add a fact to your AI memory

[Owner] Debug memory for a user

Delete one of your AI memories

Export your AI memories from this server to a file

Import AI memories from a file

List your AI memories

Search your AI memories

Check image generation service status

[Owner] Test AI memory judgment

[Owner] Test AI tool calling

Read the latest alert

Archived alerts.

Set your profile bio

Displays our music bots and their invite links.

Get a greeting from the bot's creators.

Parameters
----------
ctx : Context
The invocation context.

Get an invite link for the bot.

Provides buttons to invite the bot to a server and join the support server.

Parameters
----------
ctx : Context
The invocation context.
ephemeral : bool, optional
Whether to send the message as ephemeral (visible only to user). Defaults to False.

Opt in or out of bots message history fetching


**opt in**



**opt out**

Check the bot's latency and response times.

Displays various ping metrics including websocket, API, typing,
and database latencies along with Discord status.

Parameters
----------
ctx : Context
The invocation context.

Privacy Policy

Make the bot repeat a message.

Parameters
----------
ctx : Context
The invocation context.
message : str
The message to repeat (5-1800 characters).

Get statistics and information about the bot.

Displays bot statistics including server count, user count, and other metrics.

Parameters
----------
ctx : Context
The invocation context.

Displays given time in all Discord timestamp formats.
Example: 12/22/2005 02:20:00
You don't need to specify time. It will automatically round it to midnight.

Get statistics about the bot from Top.gg.

Displays detailed Top.gg information including server count, votes,
reviews, and rankings.

Parameters
----------
ctx : Context
The invocation context.

Vote for the bot and claim rewards.

Displays voting information and checks for unclaimed vote rewards.
Users can vote every 12 hours to receive coins, legendary items, and achievements.

Parameters
----------
ctx : Context
The invocation context.

Notes
-----
Rewards include:
- 7,500 coins
- Random legendary item
- Voting achievements

Get weather data for a location.

Fetches current weather information from OpenWeatherMap API.
Supports city names, zip codes, and various location formats.

Parameters
----------
ctx : Context
The invocation context.
location : str, optional
Location to get weather for. Can be city name, zip code, or "city,country" format.

Examples
--------
/weather New York,NY
/weather London,UK
/weather 90210
/weather Tokyo
/weather stoneville nc

Automod feature configuration commands (text-only).

Parameters
----------
ctx : GuildContext
The invocation context.

Notes
-----
For easier setup, see the dashboard at
https://akiko.motzumoto.com/dashboard.


**automod crawl_status**
Check the status of the ban crawl.

Parameters
----------
ctx : GuildContext
The invocation context.


**automod check_warnings**
Check a user's warning count and trigger escalation if threshold reached.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.Member
The member to check warnings for.


**automod avatar_check**
Configure the avatar check feature for the current guild.

Rejects users who join with a default (unset) avatar. The user is
DM'd an explanation before being kicked or banned.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AvatarCheckFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, and punishment (ban or kick).


**automod join_age**
Configure the account age gate for the current guild.

Prevents newly created Discord accounts from joining by enforcing
a minimum account age (e.g. 7 days). The user is DM'd an explanation
with their account creation date before being kicked or banned.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AccountAgeFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, minimum account age duration,
and punishment (ban or kick).


**automod cleanup_bot_bans**
Remove bot bans from the ban_history table.

This will check the top 20 users with the most bans,
identify which are bots, and delete their records.

Parameters
----------
ctx : GuildContext
The invocation context.


**automod stop_crawl**
Stop the currently running ban crawl.

Parameters
----------
ctx : GuildContext
The invocation context.


**automod ban_tracking**
Configure the cross-server ban tracking system.

Tracks users banned across multiple servers and provides alerts
and auto-actions based on configurable thresholds.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : BanTrackingFlags
Configuration flags including log channel, time window,
thresholds, and auto-action settings.


**automod link_filter**
Configure the link filter feature for the current guild.

Blocks or allows URLs in messages based on configurable domain
whitelists and blacklists. Discord invite links can be blocked
independently of the domain lists. Enable phishing detection to
automatically identify and remove malicious links using threat
intelligence from Sinking Yachts and Phish.Observer.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : LinkFilterFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, allowed domains (whitelist),
blocked domains (blacklist), whether to allow invites,
and whether to enable phishing detection.


**automod ban_tracking_toggle**
Enable or disable ban tracking for this server.

Parameters
----------
ctx : GuildContext
The invocation context.
enabled : bool
True to enable, False to disable.


**automod cleanup_duplicates**
Remove duplicate ban entries from the ban_history table.

This command identifies and removes duplicate ban records where
the same user was banned in the same guild within 1 second of each other.
Keeps the earliest record and removes duplicates.

Parameters
----------
ctx : GuildContext
The invocation context.


**automod antihoist**
Configure the anti-hoist feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiHoistFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, hoisting characters, replacement nickname,
prevent re-hoist timeout, and timeout duration.


**automod mention_spam**
Configure the mention spam protection for the current guild.

Limits the number of user and role mentions allowed in a single
message. When a message exceeds the configured thresholds it is
deleted and the author is timed out.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : MentionSpamFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max user mentions, max role mentions,
and timeout duration.


**automod ban_tracking_status**
Check a user's ban history across all servers.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.User
The user to check.


**automod caps_emoji**
Configure the caps and emoji filter for the current guild.

Detects and acts on excessive capital letters or emoji usage.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : CapsEmojiFlags
Configuration flags including caps_threshold (percentage),
emoji_threshold (count), action (delete/warn/timeout),
and timeout_duration.


**automod antispam**
Configure the anti-spam feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiSpamFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max infractions, escalation actions,
purge limit, and timeout duration.


**automod mark_ban_valid**
Mark a specific ban as valid or invalid for tracking purposes.

Use this to mark false positive bans that shouldn't count toward
the user's ban score. This helps protect other servers by ensuring
only legitimate bans are tracked.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.User
The user whose ban to mark.
guild_id : int
The guild ID where the ban occurred.
is_valid : bool
Whether the ban should count as valid (True) or invalid (False).


**automod anti_zalgo**
Configure the anti-zalgo feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiZalgoFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, zalgo threshold, max infractions,
escalation actions, and timeout duration.


**automod duplicate_message**
Configure the duplicate message detection for the current guild.

Tracks recent messages per (guild, channel, user) and flags users
who send the same content more than a configurable number of times
within a sliding time window. Offending messages are deleted and the
user is processed through the infraction engine.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : DuplicateMessageFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max duplicate count, time window in seconds,
and timeout duration.


**automod warning_escalation**
Configure the warning escalation system for the current guild.

Automatically takes action when a user reaches the warning threshold.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : WarningEscalationFlags
Configuration flags including enabled status, threshold,
action type, and duration.


**automod crawl_bans**
Trigger a coordinated ban crawl across all clusters.

This will coordinate with other clusters to crawl all server bans
one cluster at a time to avoid rate limits. The crawl is slow and
deliberate to ensure no rate limit issues.

Parameters
----------
ctx : GuildContext
The invocation context.


**automod join_raid**
Configure join raid detection for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : JoinRaidFlags
Configuration flags including join_threshold, time_window,
auto_lockdown, and alert_channel.

Clear automod infractions for a user.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.Member
The member whose infractions to clear.
table : str | None
Optional automod table name to filter by (e.g. ``automod_antispam``).
If omitted, clears infractions from all tables.

View automod infractions for a user using an interactive component menu.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.Member
The member to look up infractions for.

Direct users to the dashboard for automod settings.

Parameters
----------
ctx : GuildContext
The invocation context.

Configure the anti-hoist feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiHoistFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, hoisting characters, replacement nickname,
prevent re-hoist timeout, and timeout duration.

Configure the anti-spam feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiSpamFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max infractions, escalation actions,
purge limit, and timeout duration.

Configure the anti-zalgo feature for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AntiZalgoFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, zalgo threshold, max infractions,
escalation actions, and timeout duration.

Configure the avatar check feature for the current guild.

Rejects users who join with a default (unset) avatar. The user is
DM'd an explanation before being kicked or banned.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AvatarCheckFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, and punishment (ban or kick).

Configure the cross-server ban tracking system.

Tracks users banned across multiple servers and provides alerts
and auto-actions based on configurable thresholds.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : BanTrackingFlags
Configuration flags including log channel, time window,
thresholds, and auto-action settings.

Check a user's ban history across all servers.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.User
The user to check.

Enable or disable ban tracking for this server.

Parameters
----------
ctx : GuildContext
The invocation context.
enabled : bool
True to enable, False to disable.

Configure the caps and emoji filter for the current guild.

Detects and acts on excessive capital letters or emoji usage.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : CapsEmojiFlags
Configuration flags including caps_threshold (percentage),
emoji_threshold (count), action (delete/warn/timeout),
and timeout_duration.

Check a user's warning count and trigger escalation if threshold reached.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.Member
The member to check warnings for.

Remove bot bans from the ban_history table.

This will check the top 20 users with the most bans,
identify which are bots, and delete their records.

Parameters
----------
ctx : GuildContext
The invocation context.

Remove duplicate ban entries from the ban_history table.

This command identifies and removes duplicate ban records where
the same user was banned in the same guild within 1 second of each other.
Keeps the earliest record and removes duplicates.

Parameters
----------
ctx : GuildContext
The invocation context.

Trigger a coordinated ban crawl across all clusters.

This will coordinate with other clusters to crawl all server bans
one cluster at a time to avoid rate limits. The crawl is slow and
deliberate to ensure no rate limit issues.

Parameters
----------
ctx : GuildContext
The invocation context.

Check the status of the ban crawl.

Parameters
----------
ctx : GuildContext
The invocation context.

Configure the duplicate message detection for the current guild.

Tracks recent messages per (guild, channel, user) and flags users
who send the same content more than a configurable number of times
within a sliding time window. Offending messages are deleted and the
user is processed through the infraction engine.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : DuplicateMessageFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max duplicate count, time window in seconds,
and timeout duration.

Configure the account age gate for the current guild.

Prevents newly created Discord accounts from joining by enforcing
a minimum account age (e.g. 7 days). The user is DM'd an explanation
with their account creation date before being kicked or banned.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : AccountAgeFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, minimum account age duration,
and punishment (ban or kick).

Configure join raid detection for the current guild.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : JoinRaidFlags
Configuration flags including join_threshold, time_window,
auto_lockdown, and alert_channel.

Configure the link filter feature for the current guild.

Blocks or allows URLs in messages based on configurable domain
whitelists and blacklists. Discord invite links can be blocked
independently of the domain lists. Enable phishing detection to
automatically identify and remove malicious links using threat
intelligence from Sinking Yachts and Phish.Observer.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : LinkFilterFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, allowed domains (whitelist),
blocked domains (blacklist), whether to allow invites,
and whether to enable phishing detection.

Mark a specific ban as valid or invalid for tracking purposes.

Use this to mark false positive bans that shouldn't count toward
the user's ban score. This helps protect other servers by ensuring
only legitimate bans are tracked.

Parameters
----------
ctx : GuildContext
The invocation context.
user : discord.User
The user whose ban to mark.
guild_id : int
The guild ID where the ban occurred.
is_valid : bool
Whether the ban should count as valid (True) or invalid (False).

Configure the mention spam protection for the current guild.

Limits the number of user and role mentions allowed in a single
message. When a message exceeds the configured thresholds it is
deleted and the author is timed out.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : MentionSpamFlags
Configuration flags including enabled status, log channel,
exempt roles/channels, max user mentions, max role mentions,
and timeout duration.

Stop the currently running ban crawl.

Parameters
----------
ctx : GuildContext
The invocation context.

Configure the warning escalation system for the current guild.

Automatically takes action when a user reaches the warning threshold.

Parameters
----------
ctx : GuildContext
The invocation context.
arguments : WarningEscalationFlags
Configuration flags including enabled status, threshold,
action type, and duration.

Ban all users who joined during the detected raid.

Use this after a raid has been detected to mass-ban the raiders.

Manually end an active raid lockdown.

Use this if the raid was a false positive (e.g., streamer raid).

Autoposting - add or remove a channel.


**autopost remove**
Remove the auto posting channel.


**autopost add**
Mention a channel to autopost to. example: `/autopost add #auto-nsfw`

Mention a channel to autopost to. example: `/autopost add #auto-nsfw`

Remove the auto posting channel.

Nsfw Commands


**nsfw e621**
Get posts from the e621 furry image board

Parameters
----------
random : bool, optional
If true, returns random results.
tags : str, optional
Search tags for the e621 command.
limit : int, optional
Limit for the number of results.
rating : {"explicit", "questionable", "safe"}, optional
Rating filter for the results.
score : int, optional
Minimum score for the results.
page : int, optional
Page number for the results.
post_id : int, optional
Specific post ID to return.
blacklisted_tags : str, optional
Tags to blacklist in the results.
keep_going : bool, optional
If true, continues to fetch results.


**nsfw rule34**
Get posts from rule34.xxx

Parameters
----------
random : bool, optional
If true, returns random results.
tags : str, optional
Search tags for the rule34 command.
limit : int, optional
Limit for the number of results.
rating : {"explicit", "questionable", "safe"}, optional
Rating filter for the results.
score : int, optional
Minimum score for the results.
page : int, optional
Page number for the results.
post_id : int, optional
Specific post ID to return.
blacklisted_tags : str, optional
Tags to blacklist in the results.
keep_going : bool, optional
If true, continues to fetch results.


**nsfw tags**
Search for Rule34 tags using autocomplete

Parameters
----------
query : str
The tag query to search for
limit : int, optional
Maximum number of tags to return (1-20, default: 10)

Get posts from the e621 furry image board

Parameters
----------
random : bool, optional
If true, returns random results.
tags : str, optional
Search tags for the e621 command.
limit : int, optional
Limit for the number of results.
rating : {"explicit", "questionable", "safe"}, optional
Rating filter for the results.
score : int, optional
Minimum score for the results.
page : int, optional
Page number for the results.
post_id : int, optional
Specific post ID to return.
blacklisted_tags : str, optional
Tags to blacklist in the results.
keep_going : bool, optional
If true, continues to fetch results.

Get posts from rule34.xxx

Parameters
----------
random : bool, optional
If true, returns random results.
tags : str, optional
Search tags for the rule34 command.
limit : int, optional
Limit for the number of results.
rating : {"explicit", "questionable", "safe"}, optional
Rating filter for the results.
score : int, optional
Minimum score for the results.
page : int, optional
Page number for the results.
post_id : int, optional
Specific post ID to return.
blacklisted_tags : str, optional
Tags to blacklist in the results.
keep_going : bool, optional
If true, continues to fetch results.

Search for Rule34 tags using autocomplete

Parameters
----------
query : str
The tag query to search for
limit : int, optional
Maximum number of tags to return (1-20, default: 10)

Manage automated message responses in this server


**autoresponder modify**
Edit an autoresponder using a form


**autoresponder remove**
Delete an auto-responder trigger


**autoresponder alias**
Manage trigger aliases


**autoresponder create**
Create an autoresponder using a form


**autoresponder view**
View all active auto-responders in this server

Manage trigger aliases


**autoresponder alias list**
View all aliases for a trigger


**autoresponder alias add**
Add an alternative trigger phrase


**autoresponder alias remove**
Remove an alternative trigger phrase

Add an alternative trigger phrase

View all aliases for a trigger

Remove an alternative trigger phrase

Create an autoresponder using a form

Edit an autoresponder using a form

Delete an auto-responder trigger

View all active auto-responders in this server

Auto role related commands


**autorole disable**
Disable auto roles for the server.


**autorole set**
Set up or update auto roles for new members.

Parameters
----------
enabled: Optional[bool]
Whether autoroles should be enabled or not. Defaults to False.
roles: Optional[str]
The role IDs or mentions (comma-separated) to be automatically assigned to new members.
Leave blank for a role selector.


**autorole remove_role**
Remove a role from auto roles.


**autorole remove**
Remove auto roles for the server.


**autorole view_settings**
View the current auto role settings.

Disable auto roles for the server.

Remove auto roles for the server.

Remove a role from auto roles.

Set up or update auto roles for new members.

Parameters
----------
enabled: Optional[bool]
Whether autoroles should be enabled or not. Defaults to False.
roles: Optional[str]
The role IDs or mentions (comma-separated) to be automatically assigned to new members.
Leave blank for a role selector.

View the current auto role settings.

Shows the servers bans with the ban reason

Group command for channel related things


**channel edit**
Edit a channel

Args:
channel (discord.TextChannel): the channel to edit


**channel delete**
Delete a channel

Args:
channel: the channel to delete


**channel rename**
Rename a channel

Args:
channel (str): the channel to rename
new_name (str): the new name for the channel


**channel create**
Create a channel

Args:
channel (str): channel name
category (discord.CategoryChannel, optional): category to create the channel in

Create a channel

Args:
channel (str): channel name
category (discord.CategoryChannel, optional): category to create the channel in

Delete a channel

Args:
channel: the channel to delete

Edit a channel

Args:
channel (discord.TextChannel): the channel to edit


**channel edit userlimit**
Set the user limit of a voice channel.

Parameters:
-----------
channel : discord.VoiceChannel
The voice channel to edit.

limit : int/str
The new user limit. If '0', 'none', 'no', 'n', 'off', or 'false', sets the user limit to None.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to set the user limit of the specified voice channel.
- If successful, a confirmation message is sent.
- If the user limit is already set to the provided limit, an error message is sent.
- If the provided limit is '0', 'none', 'no', 'n', 'off', or 'false', the user limit is set to None.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit userlimit voice-channel 10 # sets the user limit of the specified voice channel to 10
/edit userlimit voice-channel none # sets the user limit of the specified voice channel to None


**channel edit description**
Edit the topic of a text channel.

Parameters:
-----------
channel : discord.TextChannel
The text channel to edit.

topic : str
The new topic for the channel.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to edit the specified text channel's topic.
- If successful, a confirmation message is sent.
- If the topic exceeds 1024 characters, an error message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit description #general New topic for the channel # changes the topic of the specified text channel 'general'
/edit description text-channel Another new topic # changes the topic of another specified text channel


**channel edit nsfw**
Make a channel NSFW or not.

Parameters:
-----------
channel : Union[discord.TextChannel, discord.VoiceChannel]
The channel to edit, can be either a text or a voice channel.

nsfw : bool
Set the channel to be NSFW or not. True for NSFW, False for not NSFW.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to edit the specified channel's NSFW status.
- If successful, a confirmation message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit nsfw #general True # makes the specified text channel 'general' NSFW
/edit nsfw voice-channel False # makes the specified voice channel not NSFW

Edit the topic of a text channel.

Parameters:
-----------
channel : discord.TextChannel
The text channel to edit.

topic : str
The new topic for the channel.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to edit the specified text channel's topic.
- If successful, a confirmation message is sent.
- If the topic exceeds 1024 characters, an error message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit description #general New topic for the channel # changes the topic of the specified text channel 'general'
/edit description text-channel Another new topic # changes the topic of another specified text channel

Make a channel NSFW or not.

Parameters:
-----------
channel : Union[discord.TextChannel, discord.VoiceChannel]
The channel to edit, can be either a text or a voice channel.

nsfw : bool
Set the channel to be NSFW or not. True for NSFW, False for not NSFW.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to edit the specified channel's NSFW status.
- If successful, a confirmation message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit nsfw #general True # makes the specified text channel 'general' NSFW
/edit nsfw voice-channel False # makes the specified voice channel not NSFW

Set the user limit of a voice channel.

Parameters:
-----------
channel : discord.VoiceChannel
The voice channel to edit.

limit : int/str
The new user limit. If '0', 'none', 'no', 'n', 'off', or 'false', sets the user limit to None.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage channels.

discord.HTTPException
If an error occurs while editing the channel.

Notes:
------
- The command attempts to set the user limit of the specified voice channel.
- If successful, a confirmation message is sent.
- If the user limit is already set to the provided limit, an error message is sent.
- If the provided limit is '0', 'none', 'no', 'n', 'off', or 'false', the user limit is set to None.
- If an error occurs during the process, an error message is sent.

Example:
--------
/edit userlimit voice-channel 10 # sets the user limit of the specified voice channel to 10
/edit userlimit voice-channel none # sets the user limit of the specified voice channel to None

Rename a channel

Args:
channel (str): the channel to rename
new_name (str): the new name for the channel

Delete a role from the server.

Makes the bot fuck off. (leave the server)

Changes users names that are hoisting themselves (Ignores Bots)

Bans multiple members from the guild.

Parameters
----------
members : commands.Greedy[MemberID]
A list of member IDs to ban.
reason : ActionReason, optional
The reason for the ban(s).

Mute someone for a certain amount of time, from 10 seconds to 28 days.

Nicknames a user from the current server.

Deletes a channel and clones it for you to quickly delete all the messages inside of it.

Parameters:
-----------
channel : discord.TextChannel, optional
The text channel to be nuked. If not specified, a warning message is sent.

ephemeral : bool, optional
If True, the command response is ephemeral (visible only to the user who triggered the command).

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to delete or create channels.

discord.HTTPException
If an error occurs while deleting or creating channels.

Notes:
------
- The command will delete the specified channel and create a new one with the same settings.
- A confirmation message is sent before executing the nuke action.
- The action is irreversible.

Example:
--------
/nuke # deletes and clones the current channel
/nuke #general # deletes and clones the specified channel 'general'

Tells you what permissions the bot has.

A group command for managing prefixes.


**prefixes user**
A group command for managing user prefixes.


**prefixes server**
A group command for managing server prefixes.

A group command for managing server prefixes.


**prefixes server remove-all**
Remove ALL server prefixes.


**prefixes server remove**
Remove a server prefix.

Parameters
----------
prefix: str
The prefix to remove.


**prefixes server add**
Add a server prefix.

Parameters
----------
prefix: str
The prefix to add.


**prefixes server list**
List the server prefixes

Add a server prefix.

Parameters
----------
prefix: str
The prefix to add.

List the server prefixes

Remove a server prefix.

Parameters
----------
prefix: str
The prefix to remove.

Remove ALL server prefixes.

A group command for managing user prefixes.


**prefixes user add**
Add a personal prefix. These can be used globally in all servers.

Parameters
----------
prefix: str
The prefix to add.


**prefixes user remove**
Remove a personal prefix.

Parameters
----------
prefix: str
The prefix to remove.


**prefixes user list**
List your personal prefixes.


**prefixes user remove-all**
Remove ALL personal prefixes.

Add a personal prefix. These can be used globally in all servers.

Parameters
----------
prefix: str
The prefix to add.

List your personal prefixes.

Remove a personal prefix.

Parameters
----------
prefix: str
The prefix to remove.

Remove ALL personal prefixes.

Purges messages based on specified criteria.

Syntax mirrors Discord's search. Messages delete if all criteria are met unless
overridden by `require:` flag.

Valid flags:

`user:` Purges a user's messages.
`contains:` Purges messages containing a substring.
`prefix:` Purges messages starting with a string.
`suffix:` Purges messages ending with a string.
`after:` Searches messages after a message ID.
`before:` Searches messages before a message ID.
`bot: yes` Purges bot messages (excludes webhooks).
`webhooks: yes` Purges webhook messages.
`embeds: yes` Purges messages with embeds.
`files: yes` Purges messages with attachments.
`emoji: yes` Purges messages with custom emoji.
`reactions: yes` Purges messages with reactions.
`require: any or all` Sets whether any or all flags must be met to purge.

Requires Manage Messages permissions. Not usable in private messages.

Opens a modal so the user can fill out:
• reported user
• message links
• evidence links
• additional details


**report user**
Report a user to the Staff.


**report staff**
Staff commands for approving/denying reports

Parent group for report setup subcommands:
• enable
• disable
• channel
• response
• delete_after


**report_setup channel**
Set which channel staff reports should be posted to.


**report_setup response**
Set the ephemeral message text to send back to the reporter after they submit a report.


**report_setup delete_after**
Configure how many seconds before the “Are you sure?” prompt is auto-deleted


**report_setup enable**
Enable the report system once a channel and other settings are configured.


**report_setup set_embed**
Upload a JSON file (exported from EmbedBuilder) to store as the report embed template.


**report_setup disable**
Disable the report system, preventing new reports from being submitted.

Set which channel staff reports should be posted to.

Configure how many seconds before the “Are you sure?” prompt is auto-deleted

Disable the report system, preventing new reports from being submitted.

Enable the report system once a channel and other settings are configured.

Set the ephemeral message text to send back to the reporter after they submit a report.

Upload a JSON file (exported from EmbedBuilder) to store as the report embed template.

Staff commands for approving/denying reports


**report staff deny**
Staff command to deny a report by message ID.m
Attempts to DM the original reporter that their report was denied, with an optional note.


**report staff approve**
Staff command to approve a report by message ID.
Attempts to DM the original reporter that their report was approved, with an optional note.

Staff command to approve a report by message ID.
Attempts to DM the original reporter that their report was approved, with an optional note.

Staff command to deny a report by message ID.m
Attempts to DM the original reporter that their report was denied, with an optional note.

Report a user to the Staff.

Tries to reset all members nicknames in the current server (Ignores bots)

A group command for role related commands


**role add**
Adds a role to a user.

Parameters:
-----------
user : discord.Member
The member to whom the role will be added.

role : discord.Role
The role to be added to the user.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage roles or interact with the database.

discord.HTTPException
If an error occurs while adding the role to the user.

Notes:
------
- The command attempts to add the specified role to the specified user.
- If successful, a confirmation message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/role add @user @role_name # adds the specified role to the mentioned user
/role add @another_user @another_role # adds another specified role to another mentioned user


**role create**
Creates a role with the given name, permissions, hoistable, mentionable, and color.

Example: `/role create bruh 8 True True ff0000`

Look at a permission calculator for more info on permissions:
https://finitereality.github.io/permissions-calculator/

Args:
name (str): The name of the role.
permissions (str or int or None): The permissions for the role.
hoist (bool(True/False),optional): Whether to set the role as hoisted. Defaults to False.
mentionable (bool(True/False),optional): Whether to set the role as mentionable. Defaults to False.
hex_color (str, optional): The hex color code to set the role color. Defaults to None.


**role delete**
Deletes a role

Args:
role (str): the role to delete


**role remove**
Removes a role from a user.

Parameters:
-----------
user : discord.Member
The member from whom the role will be removed.

role : discord.Role
The role to be removed from the user.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage roles or interact with the database.

discord.HTTPException
If an error occurs while removing the role from the user.

Notes:
------
- The command attempts to remove the specified role from the specified user.
- If successful, a confirmation message is sent.
- The command suppresses any exceptions that may occur during message deletion.
- If an error occurs during the process, an error message is sent.

Example:
--------
/removerole @user @role_name # removes the specified role from the mentioned user
/removerole @another_user @another_role # removes another specified role from another mentioned user


**role edit**
Edit any role to add new permissions, make it hoisted, mentionable, and a new color
Example: `/role edit role_name new_name permission_value hoist:True/False mentionable:True/False hex:number`
...

Adds a role to a user.

Parameters:
-----------
user : discord.Member
The member to whom the role will be added.

role : discord.Role
The role to be added to the user.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage roles or interact with the database.

discord.HTTPException
If an error occurs while adding the role to the user.

Notes:
------
- The command attempts to add the specified role to the specified user.
- If successful, a confirmation message is sent.
- If an error occurs during the process, an error message is sent.

Example:
--------
/role add @user @role_name # adds the specified role to the mentioned user
/role add @another_user @another_role # adds another specified role to another mentioned user

Creates a role with the given name, permissions, hoistable, mentionable, and color.

Example: `/role create bruh 8 True True ff0000`

Look at a permission calculator for more info on permissions:
https://finitereality.github.io/permissions-calculator/

Args:
name (str): The name of the role.
permissions (str or int or None): The permissions for the role.
hoist (bool(True/False),optional): Whether to set the role as hoisted. Defaults to False.
mentionable (bool(True/False),optional): Whether to set the role as mentionable. Defaults to False.
hex_color (str, optional): The hex color code to set the role color. Defaults to None.

Deletes a role

Args:
role (str): the role to delete

Edit any role to add new permissions, make it hoisted, mentionable, and a new color
Example: `/role edit role_name new_name permission_value hoist:True/False mentionable:True/False hex:number`
...

Removes a role from a user.

Parameters:
-----------
user : discord.Member
The member from whom the role will be removed.

role : discord.Role
The role to be removed from the user.

Raises:
-------
discord.Forbidden
If the bot doesn't have the necessary permissions to manage roles or interact with the database.

discord.HTTPException
If an error occurs while removing the role from the user.

Notes:
------
- The command attempts to remove the specified role from the specified user.
- If successful, a confirmation message is sent.
- The command suppresses any exceptions that may occur during message deletion.
- If an error occurs during the process, an error message is sent.

Example:
--------
/removerole @user @role_name # removes the specified role from the mentioned user
/removerole @another_user @another_role # removes another specified role from another mentioned user

Sets slow mode in the specified chat channels or for all channels in the guild.

Parameters
----------
time_str : str
The duration of the slow mode. Can be specified in seconds ('s'), minutes ('m'), or hours ('h'). Use '0' to disable slow mode.
channels : commands.Greedy[discord.TextChannel], optional
A list of channels to set slow mode for, defaults to None.
category : discord.CategoryChannel, optional
The category to set slow mode for all channels under, defaults to None.
reason : str, optional
The reason for applying slow mode, by default None.

Soft bans a member from the server.
To use this command you must have Kick and Ban Members permissions.

Make someone shut up. It deletes any and all messages sent from the user in the current server.
And any threads they create.

Parameters:
-----------
user : discord.Member
The member to silence.

Notes:
------
- The command adds or removes the specified user from the "stfu" table in the database.
- If the user is not in the "stfu" table, they will be added, and a confirmation message will be sent.
- If the user is already in the "stfu" table, they will be removed, and a confirmation message will be sent.
- What this command does is deletes any messages sent by the user you want to stfu in the entire server.

Example:
--------
/stfu @user # makes the mentioned user shut up
/stfu @another_user # makes another mentioned user not shut up

Toggle commands or NSFW content in the server.

Allows server managers to enable/disable specific commands
or toggle all NSFW commands at once.

Parameters
----------
ctx : Context
The invocation context.
args : ToggleArguments
Arguments containing either a command to toggle or nsfw toggle flag.

Examples
--------
;;toggle command: ping
/toggle command:weather
/toggle nsfw:True

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

Unbans everyone from the server.
You can pass an optional reason to be shown in the audit log.
You must have Ban Members permissions.

Unmute someone

Run a vote to ban a user from the server.
member: discord.Member - The member to ban.
duration: int - How long the vote should last before it ends.


**voteban config**
Configures voteban settings for the server.

Allows administrators to set the vote duration, minimum required votes,
and the minimum percentage needed for a successful voteban.

Args:
ctx (commands.Context): The invocation context.
duration (int, optional): Duration of the voteban in seconds. Defaults to 60.
minimum_votes (int, optional): Minimum number of votes required. Defaults to 5.
minimum_percentage (float, optional): Minimum percentage of votes needed. Defaults to 60%


**voteban clear**
Clears all active votebans for the guild.


**voteban view_active**
View all active votebans for the guild.

Clears all active votebans for the guild.

Configures voteban settings for the server.

Allows administrators to set the vote duration, minimum required votes,
and the minimum percentage needed for a successful voteban.

Args:
ctx (commands.Context): The invocation context.
duration (int, optional): Duration of the voteban in seconds. Defaults to 60.
minimum_votes (int, optional): Minimum number of votes required. Defaults to 5.
minimum_percentage (float, optional): Minimum percentage of votes needed. Defaults to 60%

View all active votebans for the guild.

**welcomer edit**
Edit a welcome/leave impl in the server. See `/welcomer help` for more info.


**welcomer settings**



**welcomer help**



**welcomer disable**
Disable welcome/leave messages in this server.

Args:
_type (WelcomeTypeCustom, optional): Type of the welcome/leave image. Defaults to Both. Valid Args: join, leave, both.


**welcomer setup**
Setup a welcome/leave system in the server! See `/welcomer help` for more info.

Disable welcome/leave messages in this server.

Args:
_type (WelcomeTypeCustom, optional): Type of the welcome/leave image. Defaults to Both. Valid Args: join, leave, both.

Edit a welcome/leave impl in the server. See `/welcomer help` for more info.


**welcomer edit leave**



**welcomer edit join**

Setup a welcome/leave system in the server! See `/welcomer help` for more info.


**welcomer setup preview**



**welcomer setup leave**



**welcomer setup join**

Display a simple badge leaderboard.

Triggers a badge check and shows your current badges from newbadges.

Surface lightweight campaign prompts (chat revive, events, onboarding).
Ready for scheduling systems later; for now it is on-demand.

Curated feature showcase: top categories + flagship commands.

Personal usage stats with progress toward the next badge and pretty badge formatting.

Picks a few random slash commands from the bot and shows proper mentions
like so users can try them instantly.

Read-only overview for admins.

Lightweight “surprise me” hook that nudges users into fun/utility features.
Intentionally simple and self-contained.

Lightweight ;;profile that glues together user info from different systems.
Shows progress toward next badge (if any) and pretty badges.

Manage birthday announcements in the server.

Configure birthday settings and user birthdays for automatic announcements.

Parameters
----------
ctx : Context
The invocation context.

Subcommands
-----------
set : Set your birthday
get : Get someone's birthday
remove : Remove your birthday
settings : Manage birthday settings (admin)
listall : List all birthdays in the server


**birthday migrate**
Migrate all configured birthdays from one server to the current server.

Parameters
----------
source_guild: str
The name of the server from which to migrate birthdays.


**birthday remove**
Remove the user's birthday from the database.

Notes
-----
- This command removes the birthday entry for the invoking user in the current server.
- The user's birthday information is deleted from the database for the specific guild.
- After successful removal, a confirmation message is sent indicating that the birthday has been removed.


**birthday settings**
Birthday settings commands.


**birthday get**
Get someone's birthday

Parameters
----------
user: discord.Member | discord.User
The member you want to get the birthday of. Defaults to you.


**birthday set**
Set your birthday

Parameters
----------
year: int
Birth year.
month: int
Birth month.
day: int
Birth day.
mention_enabled: bool
Whether or not if you want to be pinged when it's your birthday, by default False.


**birthday listall**
List all users with configured birthdays in the server.

Notes
-----
- This command retrieves and displays a list of all users with configured birthdays in the server.
- The list includes the user's mention, their birthday, and their age.

Get someone's birthday

Parameters
----------
user: discord.Member | discord.User
The member you want to get the birthday of. Defaults to you.

List all users with configured birthdays in the server.

Notes
-----
- This command retrieves and displays a list of all users with configured birthdays in the server.
- The list includes the user's mention, their birthday, and their age.

Migrate all configured birthdays from one server to the current server.

Parameters
----------
source_guild: str
The name of the server from which to migrate birthdays.

Remove the user's birthday from the database.

Notes
-----
- This command removes the birthday entry for the invoking user in the current server.
- The user's birthday information is deleted from the database for the specific guild.
- After successful removal, a confirmation message is sent indicating that the birthday has been removed.

Set your birthday

Parameters
----------
year: int
Birth year.
month: int
Birth month.
day: int
Birth day.
mention_enabled: bool
Whether or not if you want to be pinged when it's your birthday, by default False.

Birthday settings commands.


**birthday settings wipe**
Wipe all birthday settings and configured channels for the server.

Notes
-----
- This command deletes all birthday settings and configured channels for the server.
- It also removes all birthday entries for users in the server.


**birthday settings set**
Set or update birthday announcement settings for the server.

Parameters
----------
announce_channel : discord.TextChannel
The channel where birthday announcements will be sent.
role: discord.Role
The role to auto-asign to users on their birthday.
message_content: str | None
Additional message content to include in birthday announcements, by default "Happy Birthday".

Notes
-----
- Existing settings will be updated if the guild already has birthday settings; otherwise, new settings will be inserted.


**birthday settings get**
Get the birthday announcement settings for your server.

Notes
-----
- This command retrieves and displays the current birthday announcement settings for the server.
- If settings are found, the announcement channel, role, and message content will be displayed.
- If no settings are found, a message indicating that there are no birthday settings set for the guild will be sent.


**birthday settings deleteuser**
Delete a user's birthday from the database.

Parameters
----------
user: discord.Member | discord.User
The user whose birthday you want to delete.

Delete a user's birthday from the database.

Parameters
----------
user: discord.Member | discord.User
The user whose birthday you want to delete.

Get the birthday announcement settings for your server.

Notes
-----
- This command retrieves and displays the current birthday announcement settings for the server.
- If settings are found, the announcement channel, role, and message content will be displayed.
- If no settings are found, a message indicating that there are no birthday settings set for the guild will be sent.

Set or update birthday announcement settings for the server.

Parameters
----------
announce_channel : discord.TextChannel
The channel where birthday announcements will be sent.
role: discord.Role
The role to auto-asign to users on their birthday.
message_content: str | None
Additional message content to include in birthday announcements, by default "Happy Birthday".

Notes
-----
- Existing settings will be updated if the guild already has birthday settings; otherwise, new settings will be inserted.

Wipe all birthday settings and configured channels for the server.

Notes
-----
- This command deletes all birthday settings and configured channels for the server.
- It also removes all birthday entries for users in the server.

Setup your bump reminder settings and set a channel


**bump watch**
Set up bump reminders for disboard.

Parameters
----------
channel : discord.TextChannel
The channel to watch for bump messages


**bump set**
Manually set the last bump time for the server.


**bump status**
Show bump reminder status and configuration


**bump remove**
Remove bump reminders for this server.


**bump edit**
Edit bump reminder settings

Edit bump reminder settings


**bump edit fallback**
Set fallback ping if primary ping doesn't respond

Default: Ping the last person who bumped the server


**bump edit embed**
Customize the reminder embed and ping settings


**bump edit channel**
Change the bump reminder channel

Change the bump reminder channel

Customize the reminder embed and ping settings

Set fallback ping if primary ping doesn't respond

Default: Ping the last person who bumped the server

Remove bump reminders for this server.

Manually set the last bump time for the server.

Show bump reminder status and configuration

Set up bump reminders for disboard.

Parameters
----------
channel : discord.TextChannel
The channel to watch for bump messages

Check your image generation credit balance

Buy image generation credits - pay only for what you use

Get Akiko Premium - Unlimited AI conversations

Manage your Akiko Premium subscription

Check your Premium status and benefits

Display your achievements and progress.

Beg for coins from Akiko.

Work commands. Specify hours (max 24) to work.


**eco work listjobs**
List available jobs for your current level.


**eco work start**
Start your job and earn money!


**eco work setjob**
Select a job, if you meet the level requirement.

List available jobs for your current level.

Select a job, if you meet the level requirement.

Start your job and earn money!

Buy one or more items from the shop.

Specify quantities with `Nx Item Name`, e.g. `3x Sword, 2 Potion, Shield`.

Browse the shop with filters for category, rarity, and price range.

Parameters
----------
category: Filter by item category
rarity: Filter by item rarity (common, uncommon, rare, epic, legendary)
min_price: Minimum price filter
max_price: Maximum price filter

Claim your daily reward.

Claim your monthly reward.

Claim your weekly reward.

Gambling commands.


**eco gamble roulette**
Bet on a roulette result.

Bet types: red, black, even, odd, number (0-36)


**eco gamble coinflip**
Flip a coin and bet on heads or tails.


**eco gamble highlow**
Guess if the next number will be higher or lower than the current one.


**eco gamble blackjack**
Play blackjack against the dealer.


**eco gamble slots**
Play the slot machine.

Play blackjack against the dealer.

Flip a coin and bet on heads or tails.

Guess if the next number will be higher or lower than the current one.

Bet on a roulette result.

Bet types: red, black, even, odd, number (0-36)

Play the slot machine.

Unified command for digging, fishing, and hunting.

Usage: gather [quantity=1]

View your or another user's inventory.

View detailed information about a legendary item.

Sell an item from your inventory.

Use 'all' or 'all ' to bulk-sell items.

Use an item from your inventory to trigger its legendary effect.

Interactive Embed builder

Executes a statement against the SQL database and returns results.

Syncs commands with oversized command detection.

sync -> global sync
sync ~ or . -> sync current guild
sync * -> copies all global app commands to current guild and syncs
sync id_1 id_2 -> syncs guilds with id 1 and 2

Lock down the server - removes @everyone send permissions from all channels.

Parameters
----------
ctx : GuildContext
The invocation context.
reason : str
Reason for the lockdown (shown in audit log).

Check if the server is currently locked down.

Parameters
----------
ctx : GuildContext
The invocation context.

Set the members role for lockdown. This role will be locked down along with @everyone.

Parameters
----------
ctx : GuildContext
The invocation context.
role : discord.Role | None
The role to lock down during lockdown. If None, clears the setting.

Unlock the server - restores original @everyone permissions.

Parameters
----------
ctx : GuildContext
The invocation context.

Music commands!


**music shuffle**
Shuffle the queue.


**music seek**
Seek to a position in the current song.

Parameters
----------
seconds: int
Position in seconds.


**music disconnect**
Disconnect from the voice channel.


**music loop**
Set the loop mode (none/one/all).

Parameters
----------
mode: str
none, one, or all.


**music volume**
Set the volume (0-100).

Parameters
----------
volume: int
Volume level 0-100.


**music pause**
Pause or resume the current song.


**music stop**
Stop and clear the queue.


**music skip**
Skip the current song.


**music clear**
Clear the queue.


**music autoplay**
Toggle autoplay (adds similar tracks when queue empties).


**music favorites**
Favorites commands!


**music nowplaying**
Show the currently playing song.


**music play**
Play a song or add it to the queue.

Parameters
----------
from_favorites: bool
Play all your saved favorites instead of searching.
search: str
Song URL or search query.


**music remove**
Remove a track from the queue by position.

Parameters
----------
index: int
1-based position in the queue.


**music queue**
Show the current queue.


**music playlist**
Playlist commands!

Toggle autoplay (adds similar tracks when queue empties).

Clear the queue.

Disconnect from the voice channel.

Favorites commands!


**music favorites show**
List all your favorites.


**music favorites play_all**
Play all your favorites.

Play all your favorites.

List all your favorites.

Set the loop mode (none/one/all).

Parameters
----------
mode: str
none, one, or all.

Show the currently playing song.

Pause or resume the current song.

Play a song or add it to the queue.

Parameters
----------
from_favorites: bool
Play all your saved favorites instead of searching.
search: str
Song URL or search query.

Playlist commands!


**music playlist play**
Play a playlist.


**music playlist remove**
Remove a song from a playlist.


**music playlist delete**
Delete a playlist.


**music playlist add**
Add songs to a playlist.


**music playlist create**
Create a new playlist.


**music playlist list**
List all your playlists.

Add songs to a playlist.

Create a new playlist.

Delete a playlist.

List all your playlists.

Play a playlist.

Remove a song from a playlist.

Show the current queue.

Remove a track from the queue by position.

Parameters
----------
index: int
1-based position in the queue.

Seek to a position in the current song.

Parameters
----------
seconds: int
Position in seconds.

Shuffle the queue.

Skip the current song.

Stop and clear the queue.

Set the volume (0-100).

Parameters
----------
volume: int
Volume level 0-100.

Reminds you of something after a specified amount of time.


**reminder list**
Shows a list of your current reminders.


**reminder clear**
Remove all your reminders


**reminder remove**
Remove a specific reminder by its ID.

Reminds you of something after a specified amount of time.

Remove all your reminders

Shows a list of your current reminders.

Remove a specific reminder by its ID.

Open the interactive setup wizard for all configurable features.

Configure sticky roles for this server.


**stickyroles bannedmembers**
Toggle whether banned members should have their roles restored if they rejoin.

Parameters
----------
enabled : bool
True to enable sticky banned members, False to disable.


**stickyroles exclude**
Exclude a role from being restored.


**stickyroles maxdays**
Set maximum days away before roles are forgotten (0 = no limit).


**stickyroles setlog**
Set the log channel for sticky roles.


**stickyroles enable**
Enable sticky roles for this server.


**stickyroles settings**
View sticky roles settings.


**stickyroles disable**
Disable sticky roles for this server.

Toggle whether banned members should have their roles restored if they rejoin.

Parameters
----------
enabled : bool
True to enable sticky banned members, False to disable.

Disable sticky roles for this server.

Enable sticky roles for this server.

Exclude a role from being restored.

Set maximum days away before roles are forgotten (0 = no limit).

Set the log channel for sticky roles.

View sticky roles settings.

Toggle vote reminders on or off.

Vote reminders are enabled by default when you vote.