PaperChatLimiter
一款功能强大、完全可配置的聊天速率限制与自动禁言插件,适用于 Paper 1.20 ~ 1.21.x 服务器。
PaperChatLimiter 旨在为服务器管理员提供对玩家聊天行为的完全控制。通过复杂的违规等级(VL)系统、可配置的冷却时间、智能垃圾信息检测以及自动升级的惩罚机制——所有这些都可以通过单个 config.yml 文件进行自定义。
功能特性
? 聊天冷却
- 设置消息之间的最小间隔(每条消息和重复内容分别计算)
- 向玩家显示剩余冷却时间
- 针对重复发送相同消息设有独立的冷却时间
?️ 智能垃圾信息检测
- 在可配置的时间窗口内检测重复的相同消息
- 支持忽略大小写比较、去除首尾空格以及特殊字符过滤选项
- 可配置触发行动前的阈值
⚡ VL(违规等级)系统
- 每次垃圾信息违规都会增加玩家的 VL 分数
- VL 会随时间自动衰减
- 基于阈值的行动 — 可在不同 VL 级别配置不同的行动:
- 警告消息
- 临时或永久禁言
- 踢出服务器
- 执行自定义控制台命令(LiteBans、封禁插件等)
- 完整占位符支持:
{player}、{uuid}、{vl}、{total}、{duration}、{duration-seconds}
? 自动禁言与惩罚升级
- 渐进式惩罚:随着屡教不改,禁言时长逐渐增加
- 可配置的升级系数(例如每次延长 2 倍、3 倍)
- 禁言前警告模式,可配置警告次数
- 离线禁言持久化(玩家跨会话保持禁言状态)
- 支持自定义禁言命令,以便与 LiteBans 等惩罚插件集成
? 权限绕过系统
- 默认禁用绕过 — 即使是 OP 玩家也会受到限制!
- 可选择启用基于权限的绕过以信任的管理员
- 三个独立的权限节点:冷却、垃圾信息检测和禁言免疫
? 管理员通知
- 拥有
chatlimiter.notify 权限的工作人员实时接收通知
- 记录所有违规行为的控制台日志
? 国际化
- 内置英文 (
en_us) 和中文 (zh_cn) 语言文件
- 易于编辑或使用自定义语言文件扩展
- 消息也可以直接在
config.yml 中覆盖
命令
| 命令 |
描述 |
权限 |
/paperchatlimiter reload |
重新加载插件配置 |
chatlimiter.reload |
/paperchatlimiter vl <player> |
查看玩家的违规等级 |
chatlimiter.vl |
/paperchatlimiter unmute <player> |
解除玩家的禁言 |
chatlimiter.unmute |
/paperchatlimiter reset <player> |
重置玩家的 VL 和禁言状态 |
chatlimiter.reset |
别名: /chatlimiter、/pcl、/cl、/chlimit
权限
| 权限 |
描述 |
默认值 |
chatlimiter.bypass.cooldown |
绕过消息冷却 |
OP |
chatlimiter.bypass.spam |
绕过垃圾信息检测 |
OP |
chatlimiter.bypass.mute |
免疫禁言(可以在被禁言时发言) |
false |
chatlimiter.notify |
接收违规通知 |
OP |
chatlimiter.reload |
重新加载插件配置 |
OP |
注意: 当 config.yml 中的 bypass.enabled 为 false(默认值)时,没有人——包括 OP——可以绕过任何限制。开启它以使用上述权限系统。
配置
所有内容均在 plugins/PaperChatLimiter/config.yml 中进行配置。主要部分包括:
- Cooldown(冷却) — 消息间隔计时
- Spam(垃圾信息) — 重复消息检测规则
- VL(违规等级) — 违规等级阈值、衰减速率和行动层级
- Mute(禁言) — 持续时间、升级设置、自定义命令
- Bypass(绕过) — 权限覆盖设置
- Notification(通知) — 管理员警报和控制台日志
持续时间字符串支持格式:30s、5m、1h、2d、1w、permanent,或直接使用纯秒数。
要求
- 服务器: Paper 1.20 ~ 1.21.x(或兼容分支)
- Java: 17 或更高版本
支持
- 发现 Bug?有功能请求?请在 GitHub 上提交 Issue。
- 欢迎提交 Pull Requests!
PaperChatLimiter —— 让您的服务器聊天环境整洁且公平。
PaperChatLimiter
A powerful, fully configurable chat rate-limiting and auto-mute plugin for Paper 1.20 ~ 1.21.x servers.
PaperChatLimiter is designed to give server administrators complete control over player chat behavior. With a sophisticated Violation Level (VL) system, configurable cooldowns, smart spam detection, and automatic punishment escalation — all fully customizable through a single config.yml file.
Features
? Chat Cooldown
- Set minimum intervals between messages (per-message and per-duplicate-content)
- Players are shown remaining cooldown time
- Separate cooldown for repeating identical messages
?️ Smart Spam Detection
- Detects repeated identical messages within a configurable time window
- Case-insensitive comparison, trim, and special character filtering options
- Configurable threshold before triggering actions
⚡ VL (Violation Level) System
- Each spam violation increases a player's VL score
- VL decays automatically over time
- Threshold-based actions — configure different actions at different VL levels:
- Warning messages
- Temporary or permanent mute
- Kick from server
- Execute custom console commands (LiteBans, ban plugins, etc.)
- Full placeholder support:
{player}, {uuid}, {vl}, {total}, {duration}, {duration-seconds}
? Auto-Mute with Escalation
- Progressive punishment: mute durations increase with repeat offenses
- Configurable escalation factor (e.g., 2×, 3× longer each time)
- Warn-before-mute mode with configurable warning count
- Offline mute persistence (players remain muted across sessions)
- Custom mute command support for integration with punishment plugins like LiteBans
? Permission Bypass System
- Disable bypass by default — even OP players are restricted!
- Optionally enable permission-based bypass for trusted staff
- Three separate permission nodes: cooldown, spam detection, and mute immunity
? Admin Notifications
- Real-time notifications for staff with the
chatlimiter.notify permission
- Console logging of all violations
? Internationalization
- Built-in English (
en_us) and Chinese (zh_cn) language files
- Easy to edit or extend with custom language files
- Messages can also be overridden directly in
config.yml
Commands
| Command |
Description |
Permission |
/paperchatlimiter reload |
Reload plugin configuration |
chatlimiter.reload |
/paperchatlimiter vl <player> |
View a player's violation level |
chatlimiter.reload |
/paperchatlimiter unmute <player> |
Unmute a player |
chatlimiter.reload |
/paperchatlimiter reset <player> |
Reset a player's VL and mute status |
chatlimiter.reload |
Aliases: /chatlimiter, /pcl, /cl, /chlimit
Permissions
| Permission |
Description |
Default |
chatlimiter.bypass.cooldown |
Bypass message cooldown |
OP |
chatlimiter.bypass.spam |
Bypass spam detection |
OP |
chatlimiter.bypass.mute |
Immune to mute (can speak while muted) |
false |
chatlimiter.notify |
Receive violation notifications |
OP |
chatlimiter.reload |
Reload plugin configuration |
OP |
Note: When bypass.enabled is false in config.yml (the default), no one — including OPs — can bypass any restriction. Toggle it on to use the permission system above.
Configuration
Everything is configured in plugins/PaperChatLimiter/config.yml. Key sections:
- Cooldown — message interval timing
- Spam — duplicate message detection rules
- VL — violation level thresholds, decay rates, and action tiers
- Mute — duration, escalation, custom commands
- Bypass — permission override settings
- Notification — admin alerts and console logging
Duration strings support: 30s, 5m, 1h, 2d, 1w, permanent, or plain seconds.
Requirements
- Server: Paper 1.20 ~ 1.21.x (or compatible forks)
- Java: 17 or higher
Support
- Found a bug? Have a feature request? Open an issue on GitHub.
- Pull requests are welcome!
PaperChatLimiter — Keeping your server chat clean and fair.
评论 0
登录后参与评分
还没有评论,来抢沙发吧