\ud83c\udf1f NameFilter \u2014 Advanced Username Filtering for Folia & Paper<\/p>\n
By ItzPritam<\/p>\n
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 \u2014 NameFilter handles it all with full case-insensitive matching and simple in-game commands.<\/p>\n
—<\/p>\n
\u2728 Features<\/p>\n
\ud83d\udd39 Case-Insensitive Filtering<\/p>\n
Detects names like ABC, Abc, aBc123, myABCname \u2014 always accurate.<\/p>\n
\ud83d\udd39 Blacklist Exact Names<\/p>\n
Block specific usernames to prevent:
\n\u2022 Impersonation (admin, owner)
\n\u2022 Known troublemakers
\n\u2022 Bots<\/p>\n
\ud83d\udd39 Partial Name Matching<\/p>\n
Blacklist “abc” \u2192 blocks “MyABCName”.
\nPerfect for catching fragments of banned names.<\/p>\n
\ud83d\udd39 Blacklist Words (Contains)<\/p>\n
Blocks usernames containing specific words.
\nExamples: “hack” \u2192 Hacker123, “test” \u2192 TesTPlAyEr, “bot” \u2192 BotUser01.<\/p>\n
\ud83d\udd39 Whitelist Bypass<\/p>\n
A real whitelist.txt file allows trusted players (staff, donors, friends) to bypass all filters.<\/p>\n
\ud83d\udd39 Clean & Simple Commands<\/p>\n
\/namefilter blacklist add Commands update config and files instantly.<\/p>\n \ud83d\udd39 Fully Folia-Compatible<\/p>\n Uses only Folia-safe events (AsyncPlayerPreLoginEvent) and is marked:<\/p>\n folia-supported: true<\/p>\n \ud83d\udd39 Lightweight & Fast<\/p>\n Zero lag, no schedulers, no async issues \u2014 fully optimized.<\/p>\n —<\/p>\n \u2699\ufe0f Configuration (config.yml)<\/p>\n Auto-generated on first startup. Kick message<\/p>\n Blacklist names<\/p>\n Blacklist words<\/p>\n Partial matching toggle<\/p>\n Whitelist file<\/p>\n Developer message option<\/p>\n Everything is simple, clean, and customizable.<\/p>\n —<\/p>\n \ud83e\uddea How it Works<\/p>\n NameFilter checks usernames before they join the server:<\/p>\n No join messages<\/p>\n No chat<\/p>\n No bypassing<\/p>\n No lag<\/p>\n Both usernames and blacklist entries are force-lowercased for perfect matching.<\/p>\n —<\/p>\n \ud83d\udce6 Supported Platforms<\/p>\n \u2714 Folia 1.20.x \u2013 1.21.x —<\/p>\n \ud83d\udee0 Use Cases<\/p>\n \ud83d\udd10 Anti-Impersonation \u2014 block names like Admin, Owner, Staff —<\/p>\n \ud83c\udfc6 Why Use NameFilter?<\/p>\n \u2022 Made specifically for Folia —<\/p>\n \ud83d\udce5 Installation<\/p>\n 1. Download the latest release JAR<\/p>\n 2. Put it in your \/plugins\/ folder<\/p>\n 3. Restart your server<\/p>\n 4. Edit config.yml & whitelist.txt<\/p>\n 5. Enjoy! \ud83c\udf89<\/p>\n —<\/p>\n \u2764\ufe0f Credits<\/p>\n Created and maintained by ItzPritam A Folia-compatible name filter plugin that blocks usernames containing blacklisted names or words.<\/p>\n","protected":false},"featured_media":108601,"template":"","meta":{"_minecraft_slug":"namefilter","_minecraft_project_id":"DD8zYZ2a","_minecraft_author":"ItzPritam09","_minecraft_license":"Apache-2.0","_minecraft_downloads":26,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"namefilter.zip","_minecraft_size_bytes":21936,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:16:03.143304Z","_minecraft_date_created":"2025-11-18T00:38:36.581116Z","_minecraft_date_modified":"2026-03-24T14:09:47.783214Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/namefilter","_minecraft_icon_attachment_id":108601,"_minecraft_imported_at":"2026-06-06T06:45:15+00:00","_minecraft_import_hash":"574a48487675b61e466f684278a46c41","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,128,129,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-108600","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/namefilter blacklist remove
\n\/namefilter blacklist list
\n\/namefilter word add
\n\/namefilter word remove
\n\/namefilter word list
\n\/namefilter whitelist add
\n\/namefilter whitelist remove
\n\/namefilter whitelist list
\n\/namefilter reload<\/p>\n
\nIncludes:<\/p>\n
\n\u2714 Paper 1.13 \u2013 1.21.x
\n\u2714 Spigot\/Bukkit (basic support)<\/p>\n
\n\ud83d\udeab Anti-Toxicity \u2014 prevent offensive usernames
\n\ud83e\udd16 Anti-Bot \u2014 block bot-like patterns (bot, xyz, spam)
\n\ud83c\udfae Community Servers \u2014 keep the environment clean and friendly<\/p>\n
\n\u2022 Zero threading issues
\n\u2022 Ultra-fast & lightweight
\n\u2022 Easy setup
\n\u2022 Highly configurable
\n\u2022 Beginner-friendly commands
\n\u2022 Works instantly
\n\u2022 No database required
\n\u2022 No dependencies<\/p>\n
\nIf you enjoy this plugin, please \u2b50 star it, share it, or leave a review!<\/p>\n","protected":false},"excerpt":{"rendered":"