🌟 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 protected. Whether you want to block offensive usernames, prevent impersonation, or stop players with banned words in their name — NameFilter handles it all with full case-insensitive matching and simple in-game commands.

✨ Features

🔹 Case-Insensitive Filtering

Detects names like ABC, Abc, aBc123, myABCname — always accurate.

🔹 Blacklist Exact Names

Block specific usernames to prevent: • Impersonation (admin, owner) • Known troublemakers • Bots

🔹 Partial Name Matching

Blacklist "abc" → blocks "MyABCName". Perfect for catching fragments of banned names.

🔹 Blacklist Words (Contains)

Blocks usernames containing specific words. Examples: "hack" → Hacker123, "test" → TesTPlAyEr, "bot" → BotUser01.

🔹 Whitelist Bypass

A real whitelist.txt file allows trusted players (staff, donors, friends) to bypass all filters.

🔹 Clean & Simple Commands

/namefilter blacklist add /namefilter blacklist remove /namefilter blacklist list /namefilter word add /namefilter word remove /namefilter word list /namefilter whitelist add /namefilter whitelist remove /namefilter whitelist list /namefilter reload

Commands update config and files instantly.

🔹 Fully Folia-Compatible

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

folia-supported: true

🔹 Lightweight & Fast

Zero lag, no schedulers, no async issues — fully optimized.

⚙️ Configuration (config.yml)

Auto-generated on first startup. Includes:

Kick message

Blacklist names

Blacklist words

Partial matching toggle

Whitelist file

Developer message option

Everything is simple, clean, and customizable.

🧪 How it Works

NameFilter checks usernames before they join the server:

No join messages

No chat

No bypassing

No lag

Both usernames and blacklist entries are force-lowercased for perfect matching.

📦 Supported Platforms

✔ Folia 1.20.x – 1.21.x ✔ Paper 1.13 – 1.21.x ✔ Spigot/Bukkit (basic support)

🛠 Use Cases

🔐 Anti-Impersonation — block names like Admin, Owner, Staff 🚫 Anti-Toxicity — prevent offensive usernames 🤖 Anti-Bot — block bot-like patterns (bot, xyz, spam) 🎮 Community Servers — keep the environment clean and friendly

🏆 Why Use NameFilter?

• Made specifically for Folia • Zero threading issues • Ultra-fast & lightweight • Easy setup • Highly configurable • Beginner-friendly commands • Works instantly • No database required • No dependencies

📥 Installation

1. Download the latest release JAR

2. Put it in your /plugins/ folder

3. Restart your server

4. Edit config.yml & whitelist.txt

5. Enjoy! 🎉

❤️ Credits

Created and maintained by ItzPritam If you enjoy this plugin, please ⭐ star it, share it, or leave a review!