Namefilter

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 /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 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!