Cro Documentation

Moderation Commands

ban (alias: kill)

Ban a user from the server. Can ban users not in the server. Includes a "Compromised account" option that auto-unbans after a security notice.

Usage: !ban [reason]

Example: !ban @Sen Spamming or !ban 374589381752913930 Bot account

Note: Requires confirmation. Can use mentions, IDs, or username#discriminator. "Compromised" bans for 1 day then unbans.

Permissions: Requires Ban Members permission.

cleanup (No aliases)

Remove Cro’s own messages from the channel.

Usage: !cleanup [search]

Example: !cleanup 50 (defaults to 100 messages)

Permissions: Requires Manage Messages permission.

editrecord (alias: editcase)

Edit the reason for a moderation case by its case ID.

Usage: !editrecord

Example: !editcase ABCDEFGH Updated: Spam violation

Permissions: Requires Kick Members permission.

kick (alias: punch)

Kick a member from the server.

Usage: !kick [reason]

Example: !kick @Sen Disruption

Note: Requires confirmation. Can’t kick users with higher or equal roles.

Permissions: Requires Kick Members permission.

lock (No aliases)

Lock a channel, preventing @everyone from sending messages.

Usage: !lock [channel]

Example: !lock #general or !lock (current channel)

Permissions: Requires Manage Channels permission.

massban (No aliases)

Ban multiple members at once with an optional message deletion period.

Usage: !massban [days] [reason]

Example: !massban 1 @Sen @User2 Spamming

Note: Requires confirmation. Days defaults to 2. Use mentions or IDs.

Permissions: Requires Ban Members permission.

mute (alias: silence)

Mute a member with an optional duration (default: 1 hour). Supports w/d/h/m/s.

Usage: !mute [duration] [reason]

Example: !mute @Sen 2h Spamming or !silence @Sen

Note: Max 28 days. Can’t mute higher or equal roles.

Permissions: Requires Moderate Members permission.

nickname (alias: nick)

Change a member’s nickname. Omitting the new nickname resets it.

Usage: !nickname [new_nick]

Example: !nick @Sen Senpai or !nick @Sen

Note: Max 32 characters.

note (alias: setnote)

Add a note to a user’s moderation record.

Usage: !note

Example: !note @Sen Watch for spam

Permissions: Requires Kick Members permission.

purge (No aliases)

Purge messages in bulk, optionally from a specific member.

Usage: !purge [search] [member]

Subcommands:

- bot [search] [prefix]: Purge bot messages or those with a prefix.

- contains [search] : Purge messages with specific text.

- embeds [search]: Purge messages with embeds.

- emoji [search]: Purge messages with custom emoji.

- files [search]: Purge messages with attachments.

- humans [search]: Purge messages by humans.

- links [search]: Purge messages with links.

- mentions [search] (alias: pings): Purge messages with mentions.

Example: !purge 50 @Sen or !purge bot 100 !

Note: Max 1000 messages. Search defaults to 100.

Permissions: Requires Manage Messages permission.

records (aliases: history, infractions)

View a user’s moderation records (warns, bans, etc.).

Usage: !records

Example: !history @Sen or !records 374589381752913930

Note: Shows up to 10 recent cases. Accepts IDs or mentions.

Permissions: Requires Kick Members permission.

role (No aliases)

Add or remove a role from a member using fuzzy matching if needed.

Usage: !role

Example: !role @Sen Moderator or !role @Sen 123456789012345678

Note: Can use role name, ID, or mention. Toggles the role’s presence.

Permissions: Requires Manage Roles permission.

softban (No aliases)

Ban and immediately unban a member to clear their message history.

Usage: !softban [days] [reason]

Example: !softban @Sen 1 Spamming

Note: Requires confirmation. Days defaults to 2 (message deletion period).

Permissions: Requires Ban Members permission.

tempban (No aliases)

Temporarily ban a member with a duration and optional message deletion period.

Usage: !tempban [days] [reason]

Example: !tempban @Sen 1d 2 Spamming

Note: Duration supports w/d/h/m/s. Days defaults to 2.

Permissions: Requires Ban Members permission.

unban (alias: pardon)

Unban a user from the server.

Usage: !unban

Example: !unban 374589381752913930

Permissions: Requires Ban Members permission.

unlock (No aliases)

Unlock a channel, restoring @everyone’s ability to send messages.

Usage: !unlock [channel]

Example: !unlock #general or !unlock (current channel)

Permissions: Requires Manage Channels permission.

unmute (aliases: unsilence, untimeout)

Remove a timeout or mute role from a member.

Usage: !unmute [reason]

Example: !unmute @Sen Behavior improved

Note: Can’t unmute higher or equal roles.

Permissions: Requires Moderate Members permission.

warn (No aliases)

Warn a member and log it to their record.

Usage: !warn [reason]

Example: !warn @Sen Spamming

Note: Sends a DM to the user if possible. Can’t warn higher or equal roles.

Permissions: Requires Kick Members permission.

warns (No aliases)

List warnings for a member or the entire server.

Usage: !warns [member]

Subcommands:

- remove : Remove a specific warning.

- clear : Clear all warnings for a member.

Example: !warns @Sen, !warns remove ABCDEFGH, !warns clear @Sen

Note: Without a member, lists all server warnings (up to 10 recent).

Permissions: Requires Kick Members permission.

Admin Commands

channelname (aliases: name, cn)

Change a channel’s name. Without a new name, shows the current name.

Usage: !channelname [channel] <new_name>

Example: !channelname #general new-general or !cn to view current name.

Permissions: Requires Manage Channels permission.

config (No aliases)

Configure server settings like logging channels. Without arguments, shows all current settings.

Usage: !config [setting] [value]

Settings: messages, profiles, mod_audit, join_leave (sets log channels).

Example: !config messages #message-logs or !config to view all.

Note: Use none to clear a setting (e.g., !config messages none).

Permissions: Requires Administrator permission.

create (Subcommand of tag)

Create a new custom tag for the server.

Usage: !tag create <name> <content>

Example: !tag create hello Hi there!

Permissions: Requires Manage Messages permission.

description (aliases: desc, topic, cd)

Change a channel’s description/topic. Without a description, shows the current topic.

Usage: !description [description]

Example: !desc Welcome to the server! or !topic to view current.

Permissions: Requires Manage Channels permission.

disable (Subcommand of joinleave, messagelogs, modaudit, starboard)

Disable specific logging or starboard features.

Usage: !joinleave disable, !messagelogs disable, !modaudit disable, !starboard disable

Example: !jl disable

Permissions: Requires Administrator permission.

eval (No aliases)

Evaluate Python code (restricted to bot owner).

Usage: !eval <code>

Example: !eval print("Hello") or !eval ```py\nawait ctx.send("Hi")\n```

Note: Outputs result or error in an embed. Bot owner only.

joinleave (alias: jl)

Manage join/leave logging settings.

Usage: !joinleave [channel]

Subcommands:

- view: Show current join/leave log channel.

- disable: Disable join/leave logging.

Example: !jl #join-logs, !jl view, !jl disable

Permissions: Requires Administrator permission.

limit (Subcommand of starboard)

Set the minimum number of stars needed for starboard.

Usage: !starboard limit <number>

Example: !sb limit 5

Note: Must be at least 1.

Permissions: Requires Administrator permission.

messagelogs (alias: ml)

Manage message logging settings (edits/deletions).

Usage: !messagelogs [channel]

Subcommands:

- view: Show current message logs channel.

- disable: Disable message logging.

Example: !ml #message-logs, !ml view, !ml disable

Permissions: Requires Administrator permission.

modaudit (alias: ma)

Manage moderation audit logging settings.

Usage: !modaudit [channel]

Subcommands:

- view: Show current mod audit log channel.

- disable: Disable mod audit logging.

Example: !ma #mod-logs, !ma view, !ma disable

Permissions: Requires Administrator permission.

starboard (alias: sb)

Manage starboard settings.

Usage: !starboard [channel]

Subcommands:

- view: Show current starboard channel and threshold.

- disable: Disable starboard.

- limit <number>: Set minimum stars needed (default: 3).

Example: !sb #starboard, !sb view, !sb limit 5

Permissions: Requires Administrator permission.

tag (No aliases)

Get or manage custom tags. Shows a tag’s content if a name is provided.

Usage: !tag [name]

Subcommands:

- create <name> <content>: Create a new tag.

- tlist: List all tags.

Example: !tag hello, !tag create hi Hello!, !tag tlist

Permissions: create requires Manage Messages; viewing is open to all.

tlist (Subcommand of tag)

List all custom tags on the server.

Usage: !tag tlist

Example: !tag tlist

toggleprefix (alias: tp)

Toggle whether default prefixes work in the server. Requires a custom prefix to disable defaults.

Usage: !toggleprefix

Example: !tp

Note: Use !config prefix <prefix> to set a custom prefix first.

Permissions: Requires Administrator permission.

view (Subcommand of joinleave, messagelogs, modaudit, starboard)

Show current settings for logging or starboard.

Usage: !joinleave view, !messagelogs view, !modaudit view, !starboard view

Example: !sb view

Permissions: Requires Administrator permission.

Casual Commands

about (aliases: info, abt)

Shows information about Cro bot, including links and prefix details.

Usage: !about

Example: !info

afk (No aliases)

Sets your AFK status with an optional message. Cro notifies others if you’re mentioned and removes it when you return.

Usage: !afk [message]

Example: !afk Be right back or !afk (defaults to "AFK")

Note: Mentions like @everyone are blocked.

avatar (aliases: av, avi, pfp)

Displays a user’s avatar. Defaults to the command user if no ID is provided.

Usage: !avatar [user_id or mention]

Example: !av or !pfp @Sen

banner (No aliases)

Displays a user’s banner. Defaults to the command user if no ID is provided.

Usage: !banner [user_id or mention]

Example: !banner or !banner 374589381752913930

Note: Returns a message if the user has no banner.

github (No aliases)

Displays a GitHub profile with stats and links.

Usage: !github

Example: !github CursedSen

invite (No aliases)

Provides a link to invite Cro to your server.

Usage: !invite

Example: !invite

issues (aliases: issue, features, request, suggestion)

Provides a link to report issues or request features for Cro.

Usage: !issues

Example: !suggestion

ping (No aliases)

Checks Cro’s latency in milliseconds.

Usage: !ping

Example: !ping

profile (aliases: userinfo, user)

Displays a user’s profile with details like ID, roles, and join dates. Defaults to the command user if no ID is provided.

Usage: !profile [user_id or mention]

Example: !userinfo or !user @Sen

reminder (aliases: remind, remindme)

Sets a reminder with a time duration and message. Supports weeks (w), days (d), hours (h), minutes (m), seconds (s).

Usage: !reminder

Example: !remind 2h Meeting time or !remindme 30m Feed the cat

Note: Max 30 days, 1000 characters. Mentions/Markdown are escaped.

reminders (No aliases)

Lists your active reminders with time remaining.

Usage: !reminders

Example: !reminders

steam (No aliases)

Displays a Steam profile with status, links, and stats using a Steam ID, vanity URL, or profile link.

Usage: !steam

Example: !steam CursedSen or !steam 76561198884824734

Note: Requires a valid Steam API key configured in the bot.

This is W.I.P

There are a LOT

Help Commands

commands (No aliases)

Lists all available commands you can use, grouped by category (cog). Hidden or permission-restricted commands are excluded.

Usage: !commands

Example: !commands

Note: Only shows commands you have permission to run in the current context.

help (No aliases)

Shows general help or detailed info for a specific command. Without a command name, provides an overview with tips and links.

Usage: !help [command_name]

Example: !help or !help ping

Note: For a command, shows its description and usage syntax (e.g., !ping).