NameFilter — Advanced Username Filtering for Folia & Paper

By ItzPritam

NameFilter is a powerful, lightweight, and fully Folia-compatible username filtering plugin designed to keep your server safe, clean, and controlled.
Whether you want to block offensive usernames, prevent impersonation, or automatically restrict players with banned words in their name — NameFilter does it all, with full case-insensitive matching and a simple command system.


---

✨ Features

Case-Insensitive Filtering

Whether the player joins as ABC, Abc, aBc123, or myABCname, the plugin detects it perfectly.

Blacklist Exact Names

Block specific usernames entirely.
Perfect for stopping:

Impersonation (e.g., “admin”, “owner”)

Known bad actors

Bot names


Partial Name Detection

Enable partial matching to block names containing blacklisted fragments.
Example:
Blacklist "abc" → blocks "MyABCName".

Blacklist Words (contains)

Block users whose name includes banned words.
Examples:

"hack" blocks "Hacker123"

"test" blocks "TeStPlAyEr"

"bot" blocks "BotUser01"


Whitelist Bypass

A real whitelist.txt file that allows specific usernames to bypass all filters.

Perfect for:

Staff

Donors

Trusted players


Clean & Simple Commands

All management happens in-game:

/namefilter blacklist add <name>
/namefilter blacklist remove <name>
/namefilter blacklist list

/namefilter word add <word>
/namefilter word remove <word>
/namefilter word list

/namefilter whitelist add <name>
/namefilter whitelist remove <name>
/namefilter whitelist list

/namefilter reload

Every command is simple, clean, and updates the config/whitelist instantly.

Fully Folia Compatible

Uses only Folia-safe events (AsyncPlayerPreLoginEvent), and is officially marked:

folia-supported: true

Lightweight & Fast

NameFilter adds zero lag, no tasks, no threading issues — fully optimized.


---

⚙️ Configuration (config.yml)

Automatically generated on first launch.

Includes:

Kick message

Blacklist names

Blacklist words

Partial matching toggle

Whitelist file name

Developer message toggle


Everything is clean, simple, customizable.


---

How it Works

NameFilter listens to player login events before they even join, ensuring:

✔ No invalid player ever appears in your world
✔ No chat, no join message
✔ No staff alerts
✔ No bypassing

The plugin force-lowercases both the username and blacklist entries, resulting in 100% reliable detection.


---

Supported Platforms

✔ Folia 1.20.x – 1.21.x

✔ Paper 1.13 – 1.21.x

✔ Spigot / Bukkit (limited testing)


---

Use Cases

Anti-Impersonation

Block names like “Admin”, “Owner”, “Staff”, etc.

Anti-Toxicity

Keep offensive usernames out automatically.

Anti-Bot

Block usernames containing “bot”, “xyz”, or known spam patterns.

Community Servers

Keep things friendly and safe for players.


---

Why Use NameFilter?

Made specifically for Folia

Zero threading issues

Ultra-fast

Easy to install

Highly configurable

Beginner-friendly commands

Works instantly out of the box

No database needed

No dependencies required



---

Installation

1. Download the latest release JAR


2. Drop it into your /plugins/ folder


3. Restart your server


4. Modify config.yml & whitelist.txt as needed


5. Done!




---

❤️ Credits

Created and maintained by:
ItzPritam

If you like this plugin, please ⭐ star the project, leave a review, or share it!