Skip to main content

👤 User Blacklist

The User Blacklist screens every new member at the moment they join. The agent checks the joiner against rules you define — username patterns, server tags, or plain-English AI criteria — and kicks or bans matches before they can see a single channel.

Overview​

When configured, the agent can:

  • Check every joining member against your blacklist rules, before any other onboarding step
  • Match on username, server tag, or AI criteria you describe in plain English
  • Kick or Ban each match, per rule
  • Post every action to a log channel — or act silently if you leave it empty
  • Stop all further join processing for actioned members: no welcome, no roles, no verification prompt

Configuration​

To configure the user blacklist:

  1. Open your project in the Fren One webapp.
  2. Select the Discord server you want to configure.
  3. In the sidebar under Agent Configuration, select Onboarding, then the User Blacklist tab.
  4. Toggle "Screen new members against a blacklist" on.

General settings​

OptionDescription
Screen new members against a blacklistMaster toggle. When a member joins, the agent checks them against the rules below and bans or kicks matches.
Log channelWhere blacklist actions are posted. Leave empty to act silently.

Blacklist rules​

Rules are created in an inline editor under Blacklist rules. Every rule combines a Rule type (what to match new members against) with an Action — Kick (default) or Ban — that fires when the rule matches.

Rule typeDescription
Username matchMatches Text to match (up to 200 characters) against the joining member's username and display name, case-insensitive. Four match modes: Exact match, Contains (default), Starts with, Ends with.
Server tagMatches the member's server (clan) tag exactly, case-insensitive. Up to 32 characters.
AI criteriaA plain-English description (up to 500 characters) that the AI evaluates for each joining member. Requires the AI service. Up to 5 AI rules.

The Add rule button stays disabled until the rule is valid — hover it to see what's missing. Saved rules appear in the list below the editor, each with a summary (for example, Username contains "…") and a Kick or Ban pill. Deleting a rule asks for confirmation first.

Evaluation order​

Rules are evaluated cheapest-first — username rules, then server-tag rules, then AI rules — and the first matching rule wins: its action is applied and no further rules are checked.

How it works in Discord​

Blacklist screening runs early in the agent's join sequence — before impersonation checks, verification, role assignment, and the welcome message. When a joining member matches a rule, the agent kicks or bans them immediately and stops all further join processing: the member is never greeted, never granted auto roles, and never asked to verify.

If a Log channel is set, each action is posted there; with no log channel, the agent acts silently. AI rules only fire when the AI service is available — screening quietly falls back to your username and server-tag rules otherwise.

Saving your changes​

This page saves in two ways. The master toggle and Log channel batch-save — edits stay local until you select Save in the bar at the bottom of the page. Rules are immediate: Add rule creates the rule right away, and deleting a rule applies as soon as you confirm.

Best practices​

Building a reliable blacklist
  • Use Kick for looser rules like Contains matches — a wrongly kicked member can rejoin, a banned one can't.
  • Reserve Ban for Exact match rules and other high-confidence patterns.
  • Set a Log channel while you tune your rules so you can see exactly who's being caught.
  • Make AI criteria specific and concrete — you have at most 5 AI rules, so each should describe one clear pattern.
Broad Contains rules

A Contains rule matches any username or display name containing the text — short or common strings can catch legitimate members. Test with Kick before escalating a rule to Ban.

Troubleshooting

Rules aren't catching anyone?

  • Check that "Screen new members against a blacklist" is toggled on.
  • Screening only runs when a member joins — existing members are never checked against the rules.
  • Username rules match case-insensitively against both the username and the display name; verify the text and match mode.

AI rules aren't firing?

  • AI criteria require the AI service — when it's unavailable, AI rules are skipped silently.
  • You can create at most 5 AI rules from the dashboard.

Nothing appears in the log channel?

  • An empty Log channel means the agent acts silently — select a channel to see actions.
  • Confirm the agent can view and send messages in the selected channel.

On this page