Skip to main content

⚠️ Warns

The Warns feature allows moderators to issue warnings to users who break community rules. It serves as an escalating disciplinary system, with configurable actions triggered when a user exceeds a set warning limit.

Overview​

This feature ensures that rule enforcement is fair and transparent. By tracking warnings over time, moderators can implement a graduated response system that gives users opportunities to correct their behavior before more severe actions are taken.

Configuration​

To access Warn Settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → ⚠️ Warns
  3. Use the Toggle Warns option to turn the feature 🟢 Enabled or 🔴 Disabled
Shortcut

Admins can jump straight to this panel with /warn_settings or /warns_settings.

Configuring Warn Settings​

Notifications​

Define the message sent by the bot when the !warn command is issued by an admin or a user with permission to issue warnings via Fren One.

Customization options:

  • Create a custom warning message that fits your community's tone
  • Include information about the warning and consequences
  • Reference community rules or guidelines
  • Available warning message variables: {name}, {warns}, {limit}.
Custom Warning Message

Make your warning message informative but not harsh. Include what rule was broken and how users can avoid future warnings.

Warn Limit​

Define how many warnings a user can receive before an automatic action is taken.

Warn Actions​

Choose what happens when a user reaches the warn limit.

Available actions:

  • Mute: Restricts the user from sending messages in the group
  • Kick: Temporarily removes the user, allowing them to rejoin later
  • Ban: Permanently removes the user from the group

Expiry​

Define the time period after which a user's warns will expire automatically. 📝 Note: If set to 0, warns will not expire.

Issuing Warnings​

Moderators can issue warnings in two ways:

By Replying to a Message​

Respond to the offending user's message with the !warn command.

By Mentioning the User​

Use the !warn @username command to warn a specific user.

Who Can Issue Warnings​

Warnings can be issued by:

  • Group Admins: Always have permission to warn users
  • Users with Warn Permission: Assigned through the Fren One Roles system
Role-Based Permissions

Learn more about assigning warn permissions in the Roles documentation.

Admin Commands​

CommandDescription
/warn [username/id/reply]Issue a warning to a user
/swarn [username/id/reply]Silently warn a user without posting a public notice
/warns [username/id/reply]Show the number of warnings a user currently has
/acquit [username/id]Remove all warnings or clear moderation actions for a user
/clearwarns [username/id]Alias for /acquit — remove warnings for a user

Best Practices​

Effective Warning System
  • Set clear rules so warnings are predictable and fair
  • Use custom notification messages to explain violations
  • Set warn limits appropriate to your community size and culture
  • Document what behaviors warrant warnings
  • Be consistent in applying warnings across all users
  • Use warnings for fixable behaviors, not for immediate ban-worthy offenses
Troubleshooting

!warn command not working?

  • Verify the Warns feature is toggled 🟢 Enabled
  • Ensure the bot has admin privileges
  • Check if the user issuing the warning has permissions to do it
  • Verify you're using the correct command syntax: !warn

Warnings not triggering actions?

  • Confirm the warn limit is set correctly
  • Check if the warn action is properly configured
  • Ensure bot has permissions for the action (mute/kick/ban)
  • Verify the warned user isn't an admin

Users not receiving warning notifications?

  • Verify notification messages are configured
  • Check if in-chat notifications are enabled
  • Ensure the bot has permission to send messages

On this page