🖤 User Blacklist

The User Blacklists feature allows administrators to proactively prevent unwanted users, such as scammers or botted airdrop-hunters, from joining the community. By banning specific names, name patterns, enforcing username requirements, or limiting excessive emoji usage in Telegram names, this feature strengthens community security.

Overview

When enabled, the Fren One bot will automatically monitor and prevent users who match blacklist criteria from joining your community. Additionally, if Fren One was not added from the launch of the community - admins can scan the chat to identify and remove existing users who violate the blacklist criteria.

Configuration

To set up user blacklist:

1. Use the /settings command in your chat
2. Navigate to 👋 Onboarding → 🖤 User Blacklist
3. Configure your blacklist settings

Banned Names

Admins can maintain a list of usernames that are banned from joining the community.

Chat commands (admin): You can also manage name patterns without opening the full menu:

• /blacklist_name — add one or more blocked name patterns (same rules as the UI; send with no args to see current rules in context).
• /unblacklist_name — remove patterns you previously added.

For the full toggle list (username required, emoji limits, scan chat), use /user_blacklist or 👋 Onboarding → 🖤 User Blacklist in /settings.

Use cases:

• Blocking usernames that impersonate mods, team members, or trusted individuals
• Preventing known scammers from joining
• Blocking suspicious username patterns

Regular Expressions

You can use regular expressions to match a series of usernames — for example, all usernames containing the word "admin".

🤖Regex Generator

Create regex for:

Username Required Toggle

Scam accounts often avoid setting up usernames to bypass moderation bots.

Toggle this option Enabled to enhance community security. It enforces a rule requiring all new users to have a Telegram username to join the group.

Benefits:

• Increases accountability
• Makes it harder for scammers to hide
• Easier to identify and track problematic users
• Automatically, mass-created accounts often do not have usernames

Emoji Limit

Bots and airdrop hunters often use excessive emojis in their usernames.

This feature limits the number of emojis allowed in a username.

Available options:

• None (no limit)
• 3 emojis
• 5 emojis
• 8 emojis
• 10 emojis

tip

Setting a reasonable emoji limit (3-5) helps filter out bot accounts while still allowing legitimate users to express themselves.

Best Practices

Effective Blacklist Management

• Regularly update your banned names list based on emerging threats
• Enable Username Required for high-security communities
• Set reasonable emoji limits to avoid blocking legitimate users
• Use regex patterns for efficient blocking of username variations

Balance Security and Accessibility

• Settings that are too restrictive may prevent legitimate users from joining
• Monitor false positives and adjust criteria as needed
• Communicate username requirements clearly in community rules

Common Use Cases

Preventing Impersonation

Block usernames that mimic your team members or official accounts:

• Add variations of admin/mod names to banned list
• Use regex to catch similar patterns
• Example regex: admin|moderator|support|official

Blocking Airdrop Hunters

These accounts often have:

• No username set
• Excessive emojis in display names
• Generic or bot-like patterns

Solution: Enable Username Required and set Emoji Limit to 3-5.

Cleaning Up Existing Communities

If you're adding Fren One to an established group:

1. Configure your blacklist settings
2. Use Scan Chat to identify violators
3. Review and remove flagged accounts
4. Monitor new joins with automated enforcement

Admin Commands

The following slash commands are available for managing the user blacklist directly in chat:

Command	Description
/blacklist_name [word/pattern]	Add a username or name pattern to the blacklist
/unblacklist_name [word/pattern]	Remove a username or name pattern from the blacklist
/unblacklist [word/pattern]	Remove an item or user from the blacklist

tip

These commands let you manage blacklist entries without opening the settings menu — useful for quickly responding to new threats in chat.

Troubleshooting

Blacklist not working for new members?

• Ensure the bot has admin privileges with ban permissions
• Check that blacklist rules are properly configured
• Verify the bot can read user information

Legitimate users being blocked?

• Review your banned names list for overly broad patterns
• Adjust emoji limits if too restrictive
• Consider temporarily disabling Username Required if needed