🌟 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
Download the latest release JAR
Put it in your /plugins/ folder
Restart your server
Edit config.yml & whitelist.txt
Enjoy! 🎉
❤️ Credits
Created and maintained by ItzPritam If you enjoy this plugin, please ⭐ star it, share it, or leave a review!
