Skip to content
Ritik Ranjan edited this page Aug 24, 2023 · 1 revision

Automatic Moderation

What is Automatic Moderation

Experience highly customizable automated moderation for your server with Parrot Bot's Automatic Moderation feature. Set up rules to automatically enforce community guidelines and maintain a healthy server environment.

Commands

  • automod automod

    • Access Automod commands.
  • automod add automod add <rule>

    • Add a new automod rule to define specific moderation actions.
  • automod edit automod edit <rule>

    • Modify an existing automod rule to fine-tune moderation settings.
  • automod info automod info <rule>

    • Retrieve detailed information about a specific automod rule.
  • automod list automod list

    • List all configured automod rules along with their settings.
  • automod remove automod remove <rule>

    • Remove an existing automod rule to adjust moderation behavior.

Utilize Parrot Bot's Automatic Moderation to ensure your server's rules are consistently upheld and maintain a positive community experience.

How to?

When adding new rule, (ex. automod add rule1) Parrot bot will ask three types of configurations, TRIGGER, CONDITION, ACTION.

IF LOGIC == TRUE AND CONDITION == TRUE THEN
    CALL ACTION
END IF

image

You need not to write those, Parrot will give you modal to input and configure, the design is very friendly, Trust me.

Automatic Moderation Triggers and Configurations

Trigger Type Configuration Description
all_caps threshold, percentage Detects messages in all capital letters.
message_mentions threshold Identifies messages with excessive mentions.
voilation voilation_name, threshold, within Monitors rule-specific violations within a specified time frame.
word_blacklist words Flags messages containing specific blacklisted words.
word_whitelist words Approves messages containing specific whitelisted words.
scam_links Identifies messages containing potential scam links.
x_user_messages_in_y_seconds messages, within Monitors the rate of messages sent by a user within a certain time.
x_channel_messages_in_y_seconds messages, within Monitors the rate of messages sent in a channel within a certain time.
user_x_mentions_in_y_seconds mentions, within Monitors the rate of mentions of a user within a certain time.
channel_x_mentions_in_y_seconds mentions, within Monitors the rate of mentions in a channel within a certain time.
message_match_regex regex Detects messages matching a specified regular expression.
nickname_match_regex regex Detects nicknames matching a specified regular expression.
nickname_word_blacklist words Flags nicknames containing specific blacklisted words.
nickname_word_whitelist words Approves nicknames containing specific whitelisted words.
x_user_attachments_in_y_seconds attachments, within Monitors the rate of attachments sent by a user within a certain time.
x_channel_attachments_in_y_seconds attachments, within Monitors the rate of attachments sent in a channel within a certain time.
join_username_match_regex regex Detects usernames of new members matching a specified regular expression.
join_username_word_blacklist words Flags usernames of new members containing specific blacklisted words.
join_username_word_whitelist words Approves usernames of new members containing specific whitelisted words.
join_username_invite Detects new members joining via an invite link.
new_member_join Triggers when a new member joins the server.
message_without_attachments Identifies messages without any attachments.
message_with_attachments Identifies messages with attachments.
message_with_more_than_x_characters characters Flags messages exceeding a certain character limit.
message_with_less_than_x_characters characters Flags messages falling below a certain character limit.
x_user_links_in_y_seconds links, within Monitors the rate of links sent by a user within a certain time.
x_channel_links_in_y_seconds links, within Monitors the rate of links sent in a channel within a certain time.

Automatic Moderation Conditions and Configurations

Condition Type Configuration Description
ignore_roles roles Excludes specific roles from being subjected to automoderation rules.
require_roles roles Enforces automoderation rules only on members with specific roles.
ignore_channels channels Excludes specific channels from being subjected to automoderation rules.
require_channels channels Enforces automoderation rules only in specified channels.
account_age_below age_in_min Applies automoderation rules to accounts below a specified age in minutes.
account_age_above age_in_min Applies automoderation rules to accounts above a specified age in minutes.
server_member_duration_below duration_in_min Applies automoderation rules to members with server tenure below a specified duration in minutes.
server_member_duration_above duration_in_min Applies automoderation rules to members with server tenure above a specified duration in minutes.
ignore_bots Excludes bots from being subjected to automoderation rules.
require_bots Applies automoderation rules only to bots.
ignore_categories categories Excludes messages in specific categories from automoderation rules.
require_categories categories Applies automoderation rules only to messages in specified categories.
new_message Triggers automoderation rules for newly sent messages.
edited_message Triggers automoderation rules for edited messages.

Automatic Moderation Actions and Configurations

Action Type Configuration Description
delete_message Automatically deletes the offending message.
plus_voilation name_of_voilation Increments a specific violation count associated with the rule.
minus_voilation name_of_voilation Decrements a specific violation count associated with the rule.
reset_voilations Resets all violation counts associated with the rule.
kick_user msg Kicks the user with a specified message.
ban_user msg Bans the user with a specified message.
mute_user duration Temporarily mutes the user for the specified duration.
set_nickname nickname Sets a new nickname for the user.
delete_multiple_messages count, max_age Deletes a specified number of messages that meet certain criteria within a specified time frame.
enable_slowmode duration Activates slowmode in the channel for the specified duration.
lock_channel msg Locks the channel with a specified message.
give_role duration, role Assigns a specific role to the user for a defined duration.
remove_role duration, role Removes a specific role from the user for a defined duration.
send_message msg, delete_after, channel Sends a specified message in a designated channel and deletes it after a defined time.

Clone this wiki locally