原创 闭源 BadWordFilter——脏话过滤器 1.0.0

BadWordFilter —— 违禁词过滤 + 独立禁言系统

一款集违禁词过滤与独立禁言系统于一体的 Paper/Folia 聊天管理插件，开箱即用，无需任何外部依赖。

功能亮点

违禁词过滤：不区分大小写，支持部分匹配，可替换为 *** 或完全拦截
警告系统：三次违规触发处罚，每次全服广播
警告超时清零：玩家 5 分钟未触发警告，计数自动归零
独立禁言：内置禁言系统，不依赖 LiteBans、EssentialsX 等外部插件
IP 禁言：基于 IP 的禁言，防止玩家换号继续发言
禁言剩余时间提示：被禁言玩家尝试发言时，显示剩余禁言时间
自动到期解禁：定时任务自动处理到期禁言
孤儿权限自动清理：当 badwordfilter.muted 权限无对应禁言记录时，自动移除
解封支持玩家名：/badword unmuteip 支持通过玩家名解封 IP 禁言
广播隐藏 IP：解封广播不暴露玩家真实 IP 地址
支持 Folia：完美兼容 Folia 多线程环境

指令列表

/badword mute <玩家名> [时长] 普通禁言（权限：badword.admin）
/badword muteip <玩家名> [时长] IP 禁言（权限：badword.admin）
/badword unmute <玩家名> 解禁玩家（权限：badword.admin）
/badword unmuteip <玩家名/IP> 解禁 IP，支持玩家名（权限：badword.admin）
/badword add <词> 添加违禁词（权限：badword.admin）
/badword remove <词> 移除违禁词（权限：badword.admin）
/badword list 查看违禁词列表（权限：badword.admin）
/badword reload 重载配置（权限：badword.admin）
/badword reset <玩家名> 重置玩家违规计数（权限：badword.admin）

权限 badword.admin 默认只有 OP 拥有。

时长格式

30s：30 秒

10m：10 分钟

2h：2 小时

1d：1 天

1h30m：1 小时 30 分钟

不填时长：永久禁言

配置文件

config.yml：插件主配置文件（违禁词列表、处罚阈值、广播消息等）

mute.yml：普通禁言记录

muteip.yml：IP 禁言记录

默认配置说明

违规阈值：3 次触发自动 IP 禁言 10 分钟

警告超时：5 分钟未触发则计数归零

违禁词列表：预设大量中文辱骂词汇（含拼音变体）

替换模式：默认将违禁词替换为 ***

兼容性

支持的服务端：Spigot、Paper、Folia、Purpur、PufferFish、Leaves
支持版本：1.21.x（1.21.1 ~ 1.21.11）

安装步骤

将 BadWordFilter-1.1.0.jar 放入服务器 plugins/ 文件夹

重启服务器

根据需要修改 config.yml 中的违禁词列表和处罚命令

执行 /badword reload 重载配置

更新记录

v1.0.0 2026-07-29
初始版本发布：违禁词过滤 + 警告系统 | 独立禁言 + IP 禁言 | 自动到期解禁 | 孤儿权限自动清理 | 私信指令过滤 | 支持 Folia

v1.1.0 2026-07-30
修复私信指令（/msg、/tell、/w 等）绕过禁言的问题
修复 IP 禁言自动到期解禁广播暴露 IP 地址的问题
扩充违禁词列表，新增大量辱骂词汇及变体
删除部分冗余违禁词

数据统计

​