? NameFilter — 适用于 Folia 与 Paper 的高级用户名过滤插件
由 ItzPritam 制作
NameFilter 是一款强大、轻量且完全兼容 Folia 的用户名过滤插件,旨在保持服务器的安全、整洁与防护。无论您是想屏蔽不当用户名、防止冒充行为,还是阻止名字中包含违禁词的玩家——NameFilter 都能通过全不区分大小写的匹配和简单的游戏内命令来处理这一切。
✨ 功能特性
? 不区分大小写过滤
检测如 ABC、Abc、aBc123、myABCname 等名称——始终精准无误。
? 黑名单精确匹配
阻止特定用户名以防止:
• 冒充(admin, owner)
• 已知捣乱者
• 机器人账号
? 部分名称匹配
将 "abc" 加入黑名单 → 阻止 "MyABCName"。
非常适合捕捉被禁名称的片段。
? 黑名单词汇(包含匹配)
阻止包含特定词汇的用户名。
示例:"hack" → Hacker123, "test" → TesTPlAyEr, "bot" → BotUser01。
? 白名单绕过
一个真实的 whitelist.txt 文件允许受信任的玩家(工作人员、捐赠者、朋友)绕过所有过滤规则。
? 简洁明了的命令
/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
命令会立即更新配置文件和文件内容。
? 完全兼容 Folia
仅使用 Folia 安全的事件(AsyncPlayerPreLoginEvent),并标记为:
folia-supported: true
? 轻量且快速
零延迟,无调度器,无异步问题——完全优化。
⚙️ 配置 (config.yml)
首次启动时自动生成。
包括:
踢出消息
黑名单名称
黑名单词汇
部分匹配开关
白名单文件
开发者消息选项
一切简单、整洁且可定制。
? 工作原理
NameFilter 在玩家加入服务器前检查其用户名:
无加入提示
无聊天信息
无法绕过
无延迟
用户名和黑名单条目都会强制转为小写以实现完美匹配。
? 支持平台
✔ Folia 1.20.x – 1.21.x
✔ Paper 1.13 – 1.21.x
✔ Spigot/Bukkit(基本支持)
? 使用场景
? 反冒充 —— 阻止 Admin、Owner、Staff 等名称
? 反毒性 —— 防止不当用户名
? 反机器人 —— 阻止类似机器人的模式(bot, xyz, spam)
? 社区服务器 —— 保持环境整洁友好
? 为什么选择 NameFilter?
• 专为 Folia 打造
• 零线程问题
• 超快且轻量
• 设置简单
• 高度可配置
• 对新手友好的命令
• 即时生效
• 无需数据库
• 无依赖项
? 安装步骤
-
下载最新版本的 JAR 文件
-
将其放入 /plugins/ 文件夹
-
重启服务器
-
编辑 config.yml 和 whitelist.txt
-
享受吧!?
❤️ 致谢
由 ItzPritam 创建并维护
如果您喜欢这款插件,请 ⭐ 星标它、分享它或留下评论!
? 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 <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
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!
评论 0
登录后参与评分
还没有评论,来抢沙发吧