Skip to main content

🗳️ Vote Ban

The Vote Ban feature empowers communities to collectively moderate messages and users. Members can trigger actions, such as removing a message or banning a user, by flagging their content with a predefined word.

Overview​

This feature democratizes moderation while ensuring efficient management of harmful or disruptive content. Instead of relying solely on admins, the community collectively decides when a user should be moderated, creating a more inclusive and fair moderation system.

Configuration​

To access Vote Ban settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → 🗳️ Vote Ban
  3. Use the Toggle Vote Ban option to turn the feature 🟢 ON or 🔴 OFF

Configuring Vote Ban Settings​

Saves Enabled​

Allows other users to cast a save vote in case someone is being unfairly targeted. If enough save votes are received in time, the action is canceled.

Protecting Against Abuse

Enable saves to prevent coordinated attacks or false accusations. This creates a balanced voting system where the community can defend innocent users.

Vote Command​

Define the word members must use to initiate a vote.

Example: Setting the vote word as ban means members must type ban in response to a message to initiate a vote against the user or their message.

Common vote commands:

  • ban - Direct and clear
  • remove - Less harsh terminology
  • kick - Temporary removal indicator
  • vote - Neutral option
Choose Wisely

Pick a vote command that's unlikely to be used in normal conversation to prevent accidental votes.

Votes Needed​

Select the number of votes required to trigger the action.

Prompt: "The number of votes needed for a vote to pass.

🔨: The number of votes needed for a vote to pass. 😇: The number of saves needed for a vote to fail."

Recommended Settings by Community Size
  • Small groups (10-50 members): 3-5 votes
  • Medium groups (50-200 members): 5-10 votes
  • Large groups (200+ members): 10-20+ votes

Time Limit​

Specifies the cooldown time (in seconds) before a new vote can be initiated.

Use case: Prevents vote flooding and gives the community time between voting sessions.

Vote Expiry Time​

Defines how long (in minutes) a vote remains active before it expires.

📝 Note: If set to 0, the vote will never expire.

Choosing Expiry Time

Balance between giving enough time for votes to accumulate and preventing stale votes from lingering. Active communities can use shorter times (1-10m), while quieter groups may need longer periods (60m+).

Action​

You can define the trigger word and choose what action should be taken:

Available actions:

  • Mute: Silence the user temporarily or permanently
  • Kick: Remove the user, allowing them to rejoin
  • Ban: Permanently remove the user from the group
  • ⏲️ Duration: Set the duration (in days) for which the user is restricted.

Additional option:

  • Delete previous messages: To keep the chat clean, you can enable the option to remove that user's previous messages from the group
Message Deletion

Enabling message deletion will remove the user's chat history. Use this cautiously as it permanently erases their contributions.

Vote Ban in Action​

Here's how the Vote Ban process works:

Step 1: Initiate Vote​

A community member types the predefined vote word (e.g., ban) in response to a user's message.

[User2 posts spam]
User1: ban

Step 2: Bot Announcement​

The bot announces the proposal:

"{User1} is proposing to ban {User2}. Do you agree?"

Step 3: Community Votes​

The group members can choose between two options:

  • Ban: Vote to ban the user
  • Save: Vote to save the user (if saves are enabled)

Step 4: Resolution​

Once the required number of votes is reached (for either Ban or Save), the bot takes the corresponding action:

  • Ban: The user is banned from the group
  • Save: The user remains in the group, and the vote is closed
Vote Progress

The bot typically shows vote progress in real-time, displaying how many votes have been cast and how many are needed.

Common Use Cases​

Democratic Spam Control​

Scenario: Community-driven spam management.

Configuration:

  • Vote Command: ban
  • Votes Needed: 5
  • Action: Ban + Delete previous messages
  • Vote Expiry: 60 minutes
  • Saves Enabled: Yes

Result: Community quickly removes spammers while protecting false positives.

Gentle Moderation​

Scenario: Give users chances to reform.

Configuration:

  • Vote Command: kick
  • Votes Needed: 3
  • Action: Kick (no message deletion)
  • Vote Expiry: 90 minutes
  • Saves Enabled: Yes

Result: Temporary removal with opportunity to rejoin and improve behavior.

High-Threshold Protection​

Scenario: Prevent abuse in large communities.

Configuration:

  • Vote Command: remove
  • Votes Needed: 15
  • Action: Mute
  • Vote Expiry: 120 minutes
  • Saves Enabled: Yes

Result: Requires significant community consensus before action.

Zero-Tolerance Scam Prevention​

Scenario: Quick response to obvious scams.

Configuration:

  • Vote Command: scam
  • Votes Needed: 3
  • Action: Ban + Delete previous messages
  • Vote Expiry: 30 minutes
  • Saves Enabled: No

Result: Fast permanent removal of scammers.

Best Practices​

Effective Vote Ban System
  • Set vote thresholds proportional to your community size
  • Enable saves to protect against coordinated abuse
  • Use clear, unambiguous vote commands
  • Set reasonable expiry times (60-120 minutes typically works well)
  • Combine with admin oversight for serious violations
  • Educate community on when voting is appropriate
  • Monitor vote patterns to identify abuse
  • Consider different actions for different severity levels
Preventing System Abuse
  • Watch for coordinated voting campaigns
  • Set minimum account age/activity requirements (if possible)
  • Use higher vote thresholds in large communities
  • Enable saves to allow community defense
  • Review vote bans regularly to ensure fairness
  • Have admins ready to intervene in unjust votes
  • Consider time limits between votes to prevent harassment
  • Document clear guidelines on appropriate use

Troubleshooting​

Vote command not triggering?

  • Verify Vote Ban is toggled 🟢 ON
  • Check if the vote command matches exactly (case-sensitive)
  • Ensure the command is used as a reply to a message
  • Verify bot has necessary permissions

Votes not counting?

  • Check if the vote expiry time has passed
  • Verify users are using the correct voting buttons
  • Ensure the same user isn't voting multiple times
  • Confirm bot has access to count votes

Save votes not working?

  • Verify "Saves Enabled" is turned on
  • Check if save threshold is set appropriately
  • Ensure save votes are cast before expiry

Action not executing?

  • Confirm bot has admin privileges
  • Check if bot has permissions for the action (mute/kick/ban)
  • Verify the user being voted on isn't an admin or whitelisted
  • Ensure vote threshold was actually reached

Too many false positive votes?

  • Increase votes needed threshold
  • Enable saves feature
  • Extend vote expiry time for more careful consideration
  • Educate community on proper use
  • Consider admin oversight for all votes

Advanced Strategies​

Tiered Voting System​

Implement different vote commands for different actions:

Severity Tiers:

  • warn - 3 votes needed → Issue warning
  • kick - 5 votes needed → Temporary removal
  • ban - 10 votes needed → Permanent ban

(Note: Requires multiple vote ban configurations or manual implementation)

Protected Users​

Combine with User Whitelist to protect:

  • Community managers
  • Verified members
  • Long-standing contributors
  • Official partners

Integration with Reputation​

Track users who frequently trigger vote bans:

  • Users with multiple vote bans → Automatic permanent ban
  • Users with zero vote bans → Trusted member status
  • Users who cast accurate votes → Moderation privileges

Community Guidelines Enforcement​

Create specific vote commands for rule violations:

  • spam - For spam content
  • scam - For scam attempts
  • toxic - For harassment/toxicity
  • offtopic - For irrelevant content

Hybrid Moderation​

Combine Vote Ban with other features:

  • Filters: Auto-delete spam, vote ban for repeat offenders
  • Triggers: Auto-warn first, vote ban after warnings
  • Report System: Admin review for reports, vote ban for community consensus
  • Warns: Build on existing warning system

Statistics and Monitoring​

Track vote ban effectiveness:

  • Number of initiated votes
  • Success rate (bans vs saves)
  • Most active voters
  • Frequently targeted users
  • False positive rate

Use this data to:

  • Adjust vote thresholds
  • Identify abuse patterns
  • Recognize helpful community members
  • Refine moderation policies
tip

Remember to give the Fren One bot admin privileges in your chat for all Vote Ban features to work properly. The bot needs permission to mute, kick, or ban users based on community votes.