ChatLimiter 防广告/防刷屏/防恶意信息

ChatLimiter 插件介绍
概述

ChatLimiter（亦称 PaperChatLimiter）是一款面向 Minecraft Java 版 Paper 服务端的聊天行为管控插件，由 LiquidTeam 开发并发布于 Modrinth。插件旨在为服务器管理员提供对玩家聊天行为的完整控制，以轻量级的方式解决 spam 机器人攻击与玩家刷屏问题。
此插件可以有效防御XEMC宣传机器人进入，支持手动配置关键字。
插件名称：ChatLimiter (PaperChatLimiter)
创建者：LiquidTeam
最新版本：1.5.0
许可协议：MIT
兼容版本：Minecraft Java Edition 1.21.x / 1.20.x
运行平台：Paper
项目地址：https://modrinth.com/plugin/chatlimiter

功能特性
聊天冷却（Chat Cooldown）
设置消息之间的最小发送间隔
分别针对普通消息与重复内容设置独立冷却
向玩家展示剩余冷却时间
对连续发送相同消息设置单独冷却
智能 Spam 检测
在可配置的时间窗口内检测重复消息
支持大小写不敏感比较、首尾去空格、特殊字符过滤
可配置触发动作前的阈值
VL（违规等级）系统
每次 spam 违规都会提升玩家的 VL 分数
VL 随时间自动衰减
基于阈值的分级动作，可在不同 VL 等级配置不同惩罚：
警告消息
临时或永久禁言
踢出服务器
执行自定义控制台命令（如 LiteBans、封禁类插件等）
完整占位符支持：{player}、{uuid}、{vl}、{total}、{duration}、{duration-seconds}
自动禁言与阶梯处罚
渐进式惩罚：禁言时长随违规次数递增
可配置递增系数（如每次 2 倍、3 倍延长）
支持"先警告后禁言"模式，可配置警告次数
离线禁言持久化（跨会话保持禁言状态）
自定义禁言命令，可与 LiteBans 等惩罚插件集成
权限绕过系统
默认禁用绕过——即使是 OP 玩家也受限制
可选择为受信任的管理员启用基于权限的绕过
三个独立权限节点：冷却绕过、Spam 检测绕过、禁言免疫
管理员通知
拥有 chatlimiter.notify 权限的管理员会实时收到通知
所有违规行为均记录到控制台
国际化
内置英文（en_us）与中文（zh_cn）语言文件
易于编辑或扩展自定义语言文件
也可直接在 config.yml 中覆盖消息
命令过滤与防脚本机器人（v1.5.0+）
新增 CommandListener，通过 PlayerCommandPreprocessEvent 拦截玩家命令，包括 /e、/me 等服务器上未注册的命令
预配置 /e 和 /me 拦截关键词，命中后可通过 LiteBans 立即封禁玩家 IP 7 天
复用关键词系统，支持 STARTS_WITH / EQUALS / CONTAINS / REGEX 匹配模式
支持 command / ban / kick / mute / warn 等动作
新增 {command}（完整命令文本）与 {args}（命令参数）占位符
违禁词自动封禁（v1.4.0+）
支持基于违禁词自动封禁
支持自动执行命令
优化控制台输出消息
命令

| 命令 | 说明 | 所需权限 |
|---|---|---|
| /paperchatlimiter reload | 重载插件配置 | chatlimiter.reload |
| /paperchatlimiter vl | 查看玩家的违规等级 | chatlimiter.reload |
| /paperchatlimiter unmute | 解除玩家禁言 | chatlimiter.reload |
| /paperchatlimiter reset | 重置玩家的 VL 与禁言状态 | chatlimiter.reload |
权限节点

| 权限 | 说明 | 默认值 |
|---|---|---|
| chatlimiter.bypass.cooldown | 绕过消息冷却 | OP |
| chatlimiter.bypass.spam | 绕过 Spam 检测 | OP |
| chatlimiter.bypass.mute | 禁言免疫（被禁言时仍可发言） | false |
| chatlimiter.notify | 接收违规通知 | OP |
| chatlimiter.reload | 重载插件配置 | OP |
安装方法
从 Modrinth 下载插件 jar 文件。
将 jar 文件放入 Paper 服务端的 plugins/ 目录。
启动或重启服务器，插件会自动生成配置文件与语言文件。
根据需要修改 plugins/ChatLimiter/config.yml。
在控制台执行 /paperchatlimiter reload 使配置生效。
适用场景
公共服务器防御 spam 机器人攻击
防止玩家刷屏与重复消息
对聊天频率、命令频率进行综合管控
需要阶梯式、可集成的惩罚工作流（配合 LiteBans 等插件）
相关链接
Modrinth 项目页：https://modrinth.com/plugin/chatlimiter
创建者：LiquidTeam