ChatSentinel
适用于 Paper、Folia、Purpur、Spigot 和 Bukkit 1.21+ 的聊天过滤器。在侮辱性或歧视性言论进入聊天之前将其取消。工作人员会收到游戏内提示,并可选择通过 Discord Webhook 记录日志。
检测内容
空格、标点符号、重复字母、Leetspeak(数字/符号替代字母)、重音字符、全角字符以及形似字母。拼写错误采用模糊匹配处理。缩写词如 hs 或 kys 可单独列出。安全词汇如 class 或 assassin 列入白名单。
模式:SMART(默认)、SUBSTRING、WORD。
语言支持
德语、英语、西班牙语、法语、意大利语、葡萄牙语、荷兰语、波兰语、俄语、土耳其语。plugins/ChatSentinel/languages/ 目录下的每个文件都包含界面文本和词汇表。全局黑名单始终加载。
当消息被拦截时
- 消息被取消
- 发送者可收到通知
- 拥有
chatsentinel.notify 权限的工作人员会收到警报
- 可选的控制台命令(支持
%player%、%word%、%message% 占位符)
- 在时间窗口内多次触发后,可选的升级处理机制
命令
| 命令 |
功能 |
/cs reload |
重载配置和语言文件 |
/cs test <message> |
检查某条消息是否会被拦截 |
/cs info |
显示已加载的词汇数量 |
| 权限 |
默认值 |
chatsentinel.admin |
op |
chatsentinel.bypass |
false |
chatsentinel.notify |
op |
安装
将 jar 文件放入 plugins 文件夹,启动服务器,编辑 config.yml,然后运行 /cs reload。需要 Java 21。
| 拼写错误 / 误拼 | huhrensohn · arschlosch | ✅ |
| 软变体 | nega · naga | ✅ |
| 缩写词 | hs · kys · hdf | ✅ |
? 模糊匹配引擎 超越了你的词汇列表范围 —— 你无需预测玩家发明的每一种变体。内置的 白名单 确保像 class、assassin、analysis 和 grass 这样的安全词汇永远不会被标记。
三种匹配模式让你选择过滤的激进程度:SMART(默认)、SUBSTRING 或 WORD。
? 包含的语言
?? 德语 · ?? 英语 · ?? 西班牙语 · ?? 法语 · ?? 意大利语 · ?? 葡萄牙语 · ?? 荷兰语 · ?? 波兰语 · ?? 俄语 · ?? 土耳其语
每种语言的文件位于 /plugins/ChatSentinel/languages/<code>.yml,其中包含 两者:界面消息 和 被封禁的词汇表。想要另一种语言?复制一个文件,重命名它,翻译它——完成。
? Discord Webhook 日志记录
启用 Webhook 后,每条被拦截的消息都会作为富嵌入推送到你指定的工作人员频道:
?️ Message blocked
Player: Steve
Trigger word: idiot
Blocked count: 3
Original message: you are an idiot
ChatSentinel • 2026-07-08 14:33:07 UTC
- ? 自定义用户名、头像和嵌入颜色
- ? 拦截发生时可选的角色提及(Ping)
- ? 完全异步发送 —— 对聊天性能 零 影响
♻️ 自动配置更新器
这是服务器所有者喜爱的功能。当新插件版本添加配置选项时:
- 你只需放入新的
.jar 文件
- ChatSentinel 检测到旧配置文件,备份 它,并合并新的键值
- 你配置的所有值都会保留 —— 无需删除任何内容,也无需重新输入 ✅
⚡ 消息被拦截时的操作
- ? 取消消息,使无人能看到
- ? 告知发送者 "你的消息已被系统拦截"
- ? 在游戏内通知在线工作人员
- ?️ 运行自定义控制台命令(支持
%player% · %word% · %message%)
- ? 升级处理 —— 在时间窗口内 X 次拦截后自动惩罚
? 命令与权限
| 命令 |
描述 |
/cs reload |
重载配置和语言文件 |
/cs test <message> |
测试某条消息是否会被拦截 |
/cs info |
显示状态及已加载词汇数量 |
| 权限 |
默认值 |
描述 |
chatsentinel.admin |
op |
访问 /cs 命令 |
chatsentinel.bypass |
false |
永不受到过滤的玩家 |
chatsentinel.notify |
op |
接收游戏内拦截警报 |
? 安装步骤
- 下载
ChatSentinel.jar
- 将其放入服务器的
/plugins 文件夹
- 启动服务器(生成配置和语言文件)
- 编辑
config.yml —— 设置语言、添加 Discord Webhook、调整过滤器
- 运行
/cs reload —— 保护生效!?
要求: Paper · Folia · Purpur · Spigot · Bukkit 1.21+ · Java 21
⚙️ 配置
所有设置均可在 config.yml 中配置。点击展开完整默认文件:
? config.yml (点击查看)
config-version: 2
language:
selected: "en"
load-all-word-lists: true
detection:
enabled: true
obfuscation:
ignore-case: true
strip-accents: true
normalize-leetspeak: true
collapse-repeats: true
strip-separators: true
mode: "SMART"
fuzzy:
enabled: true
max-distance: 2
min-word-length: 4
blocked-abbreviations:
- "hs"
- "hdf"
- "htf"
- "kys"
- "stfu"
- "gtfo"
- "vpd"
- "ndh"
whitelist:
- "assassin"
- "class"
- "grass"
- "analysis"
- "cockpit"
- "shitake"
extra-blocked-words: []
action:
block-message: true
notify-sender: true
notify-staff: true
commands: []
escalation:
threshold: 0
window-seconds: 300
commands:
- "kick %player% Repeated inappropriate language."
discord:
enabled: false
webhook-url: ""
username: "ChatSentinel"
avatar-url: ""
use-embed: true
embed-color: 15158332
ping-role-id: ""
misc:
log-to-console: true
startup-banner: true
? 支持与反馈
发现误报或希望捆绑其他语言?
留下评论——欢迎贡献!❤️
保持聊天清洁,守护社区安全。 ?️
ChatSentinel
Chat filter for Paper, Folia, Purpur, Spigot and Bukkit 1.21+. Messages with insults or slurs are cancelled before they hit the chat. Staff can get an in-game ping and an optional Discord webhook log.
What it catches
Spacing, punctuation, repeated letters, leetspeak, accents, full-width characters and look-alike letters. Typos are handled with a fuzzy match. Abbreviations like hs or kys can be listed separately. Safe words such as class or assassin go on the whitelist.
Modes: SMART (default), SUBSTRING, WORD.
Languages
German, English, Spanish, French, Italian, Portuguese, Dutch, Polish, Russian, Turkish. Each file under plugins/ChatSentinel/languages/ has UI text and a word list. A global slur list is always loaded.
When a message is blocked
- message is cancelled
- sender can be notified
- staff with
chatsentinel.notify can be alerted
- optional console commands (
%player%, %word%, %message%)
- optional escalation after repeated hits in a time window
Commands
| Command |
What it does |
/cs reload |
reload config and language files |
/cs test <message> |
check if a message would be blocked |
/cs info |
loaded word count |
| Permission |
Default |
chatsentinel.admin |
op |
chatsentinel.bypass |
false |
chatsentinel.notify |
op |
Install
Drop the jar into plugins, start the server, edit config.yml, run /cs reload. Java 21.
| Typos / misspellings | huhrensohn · arschlosch | ✅ |
| Soft variations | nega · naga | ✅ |
| Abbreviations | hs · kys · hdf | ✅ |
? The fuzzy engine generalizes beyond your word list — you don't have to predict every variation players invent. A built-in whitelist keeps safe words like class, assassin, analysis and grass from ever being flagged.
Three matching modes let you pick your aggressiveness: SMART (default), SUBSTRING, or WORD.
? Languages Included
?? German · ?? English · ?? Spanish · ?? French · ?? Italian · ?? Portuguese · ?? Dutch · ?? Polish · ?? Russian · ?? Turkish
Each language lives in /plugins/ChatSentinel/languages/<code>.yml and contains both the UI messages and the blocked-word list. Want another language? Copy a file, rename it, translate it — done.
? Discord Webhook Logging
Enable the webhook and every blocked message is pushed to your staff channel as a rich embed:
?️ Message blocked
Player: Steve
Trigger word: idiot
Blocked count: 3
Original message: you are an idiot
ChatSentinel • 2026-07-08 14:33:07 UTC
- ? Custom username, avatar & embed color
- ? Optional role ping when something is blocked
- ? Sent fully asynchronously — zero impact on chat performance
♻️ Auto-Config Updater
The feature server owners love. When a new plugin version adds config options:
- You just drop in the new
.jar
- ChatSentinel detects the older config, backs it up, and merges in the new keys
- Every value you configured is kept — nothing to delete, nothing to re-enter ✅
⚡ Actions When a Message Is Blocked
- ? Cancel the message so nobody sees it
- ? Tell the sender "Your message was blocked by the system"
- ? Alert online staff in-game
- ?️ Run custom console commands (
%player% · %word% · %message%)
- ? Escalation — auto-punish after X blocked messages within a time window
? Commands & Permissions
| Command |
Description |
/cs reload |
Reload config & language files |
/cs test <message> |
Test whether a message would be blocked |
/cs info |
Show status & loaded word count |
| Permission |
Default |
Description |
chatsentinel.admin |
op |
Access to /cs commands |
chatsentinel.bypass |
false |
Players who are never filtered |
chatsentinel.notify |
op |
Receive in-game block alerts |
? Installation
- Download
ChatSentinel.jar
- Drop it into your server's
/plugins folder
- Start the server (generates the config & language files)
- Edit
config.yml — set your language, add your Discord webhook, tune the filter
- Run
/cs reload — you're protected! ?
Requirements: Paper · Folia · Purpur · Spigot · Bukkit 1.21+ · Java 21
⚙️ Configuration
Everything is configurable in config.yml. Click to expand the full default file:
? config.yml (click to view)
config-version: 2
language:
selected: "en"
load-all-word-lists: true
detection:
enabled: true
obfuscation:
ignore-case: true
strip-accents: true
normalize-leetspeak: true
collapse-repeats: true
strip-separators: true
mode: "SMART"
fuzzy:
enabled: true
max-distance: 2
min-word-length: 4
blocked-abbreviations:
- "hs"
- "hdf"
- "htf"
- "kys"
- "stfu"
- "gtfo"
- "vpd"
- "ndh"
whitelist:
- "assassin"
- "class"
- "grass"
- "analysis"
- "cockpit"
- "shitake"
extra-blocked-words: []
action:
block-message: true
notify-sender: true
notify-staff: true
commands: []
escalation:
threshold: 0
window-seconds: 300
commands:
- "kick %player% Repeated inappropriate language."
discord:
enabled: false
webhook-url: ""
username: "ChatSentinel"
avatar-url: ""
use-embed: true
embed-color: 15158332
ping-role-id: ""
misc:
log-to-console: true
startup-banner: true
? Support & Feedback
Found a false positive or want another language bundled?
Leave a comment — contributions welcome! ❤️
Keep your chat clean. Keep your community safe. ?️
评论 0
登录后参与评分
还没有评论,来抢沙发吧