Moderation Commands

Tools for keeping groups safe and well-moderated.

/warn

Warn a user. Reaching the warning limit triggers an automatic action.

/warn @user [reason]

Example:

/warn @user Spamming links

/warns

Check a user's warning count and history.

/warns @user

/resetwarns

Clear all warnings for a user.

/resetwarns @user

/warnconfig

Configure warning behavior.

/warnconfig limit <number>    # Max warnings before action (default: 3)
/warnconfig action <action>   # Action on limit: kick (default: kick)

/report and /reports

Create and manage member reports.

Member flow

Reply to a message (or mention a user) and report it:

/report <reason>

When submitted, the bot forwards report context to group admins via DM.

Admin flow (group)

/reports open
/reports all
/report info <id>
/report resolve <id> [note]
/report dismiss <id> [note]
/report warn <id> [note]
/report kick <id> [note]

Admin flow (DM)

Admins can inspect and act from private chat using report ID:

/report info <id>
/report resolve <id>
/report dismiss <id>
/report warn <id>
/report kick <id>

TIP

/report info <id> includes the original quoted message context (text/media caption), plus target/reporter PN and LID identities.

/automation

No-code moderation automation rules. Trigger on message content, exact text, media type, or links.

/automation list
/automation add <trigger_type> <trigger_value> => <action> [response]
/automation toggle <rule_id>
/automation remove <rule_id>
/automation simulate <rule_id> <sample text>
/automation simulate <rule_id> --media <image|video|audio|sticker|document>
/automation dryrun <on|off>

Trigger types:

Type	Description	Example trigger value
contains	Text contains substring	discord.gg
starts_with	Text starts with prefix	!promo
exact_match	Text matches exactly (case-insensitive)	hello
regex	Text matches regex pattern	(?i)free\s+money
link	Message contains any URL	(no value needed)
media_type	Message is a specific media type	image, video, audio, sticker, document

Actions: reply, warn, delete, kick, mute

Examples:

/automation add contains discord.gg => warn
/automation add starts_with !promo => delete
/automation add exact_match hello => reply Welcome!
/automation add regex (?i)free\s+money => delete
/automation add link x.com => reply External links are reviewed by admins.
/automation add media_type sticker => delete
/automation simulate A001 this is a test message
/automation simulate A006 --media sticker
/automation dryrun on

INFO

dryrun mode lets you test live traffic safely: matching rules will only send a preview message and won't execute moderation actions.

/blacklist

Add a word to the group blacklist. Messages containing blacklisted words are auto-deleted.

/blacklist <word>

/unblacklist

Remove a word from the blacklist.

/unblacklist <word>

/antilink

Configure anti-link protection. Automatically detects and handles links in group messages.

/antilink on                           # Enable anti-link
/antilink off                          # Disable anti-link
/antilink action <warn|delete|kick>    # Set action
/antilink whitelist add <domain>       # Whitelist a domain
/antilink whitelist remove <domain>    # Remove from whitelist
/antilink whitelist                    # List whitelisted domains

Example:

/antilink on
/antilink action warn
/antilink whitelist add youtube.com
/antilink whitelist add github.com

INFO

Admins are exempt from anti-link detection.

/antidelete

Reveal deleted messages by re-sending them. Owner only.

/antidelete on                  # Enable for current group
/antidelete off                 # Disable
/antidelete forward me          # Forward deleted messages to your DM
/antidelete forward here        # Re-send in the same group