Minecraft 服务器的先进聊天过滤与案件管理系统。
关于
Gavelry 是一款聊天过滤器和案件管理插件。每条被标记的消息都会生成一个案件,并附带相关的聊天上下文,以便工作人员可以在游戏内 GUI 中查看、采取行动并关闭案件,无需修改配置文件或运行额外命令。
共有四种过滤类别:辱骂性词汇、粗俗用语、广告和垃圾信息。每种类型都有各自的处理方式、严重程度等级和升级规则。初犯垃圾信息发送者会收到警告,而重复辱骂他人的玩家将被永久禁言。具体如何处理以及何时处理,由你决定。
配置文件位于 plugins/gavelry/config.yml。
安装
将 Gavelry .jar 文件放入 PaperMC、Spigot 或 Bukkit 的 1.21.1 版本服务器的 plugins/ 文件夹中。无需其他插件。
可选集成:
| 插件 |
功能说明 |
| LiteBans |
禁言通过 LiteBans 执行,而非内置系统 |
| EssentialsX |
禁言通过 EssentialsX 执行 |
| LuckPerms |
允许设置信任组,享受宽松的过滤策略 |
| Vault |
通过 Vault 进行权限查询 |
如果未安装配置的提供商,Gavelry 将回退到其内置的禁言系统。
过滤系统
每条聊天消息都会经过四个类别的检查。每个类别可设置为以下四种处理方式之一:
| 处理方式 |
效果 |
WARN_ONLY |
消息放行,玩家收到私聊警告,同时开启案件 |
QUEUE_REVIEW |
消息被拦截,案件排队等待工作人员审核 |
AUTO_MUTE |
消息被拦截,玩家按设定时长被禁言 |
AUTO_KICK |
玩家立即被踢出服务器 |
升级机制针对单个玩家在 24 小时窗口内生效。设置阈值后,当违规次数达到该值时,Gavelry 将采取更严厉的处理方式。
案件系统
每次触发过滤条件都会创建一个案件,并保存至 SQLite 数据库。每个案件包含:
- 被标记的消息及其触发的类别
- 前后各 20 条聊天记录
- 玩家的过往违规历史
- 所有工作人员对此案件的操作日志
工作人员可在游戏内使用 /gavelry cases 或 /gvl cases 打开案件列表,并在此处处理所有相关事宜。
词库列表
词库是纯文本 .txt 文件,每行一个词条。Gavelry 内置了涵盖所有四个类别的词库。你也可以将某个类别指向远程 URL,Gavelry 将在启动及每次重载时获取该词库。
两个文件可用于调整任意类别,而无需编辑基础词库:
custom-additions.txt 向所有类别添加词条
custom-exclusions.txt 从所有类别移除词条
运行 /gvl reload 即可在不重启服务器的情况下应用更改。
集成
Discord Webhook - 新案件会自动发布到指定的工作人员频道。你可以设置最低严重程度阈值,仅发送严重违规(如辱骂或广告)的通知。
LuckPerms 信任组 - 处于信任组的玩家跳过粗俗用语和垃圾信息检查,但仍会受到辱骂性词汇的过滤。
命令
| 命令 |
功能说明 |
/gvl reload |
重载配置和词库列表 |
/gvl cases |
打开案件审核 GUI |
/gvl stats |
查看过滤统计数据 |
/gvl mute <player> <duration> <reason> |
手动禁言玩家 |
/gvl unmute <player> |
解除玩家禁言 |
/gvl history <player> |
查看玩家的历史案件 |
所有命令均支持 /gavelry 和 /gvl 两种格式。
默认情况下,OP 不拥有 gavelry.bypass 权限。除非明确授予该权限,否则服务器管理员与其他玩家一样受到过滤规则的约束。
致谢
首席开发者
(@efegorkemefe) arikutov2
感谢所有参与测试并报告问题的用户。
Advanced chat filtering and case management for Minecraft servers.
About
Gavelry is a chat filter and case management plugin. Every flagged message opens a case with the surrounding chat context attached, so staff can review it, take action, and close it from an in-game GUI without touching the config or running extra commands.
There are four filter categories: slurs, profanity, advertising, and spam. Each one has its own action, severity level, and escalation rules. A first-time spammer gets a warning. A repeat slur offender gets a permanent mute. You decide what happens and when.
Config is at plugins/gavelry/config.yml.
Installation
Drop the Gavelry .jar into your plugins/ folder on any 1.21.1 build of PaperMC, Spigot, or Bukkit. No other plugins are required.
Optional integrations:
| Plugin |
What it does |
| LiteBans |
Mutes go through LiteBans instead of the built-in system |
| EssentialsX |
Mutes go through EssentialsX |
| LuckPerms |
Lets you set trusted groups with relaxed filtering |
| Vault |
Permission lookups via Vault |
Gavelry falls back to its built-in mute system if the configured provider is not installed.
Filter System
Each chat message is checked against four categories. A category can be set to one of four actions:
| Action |
What happens |
WARN_ONLY |
Message goes through, player gets a private warning, case is opened |
QUEUE_REVIEW |
Message is blocked, case is queued for staff to review |
AUTO_MUTE |
Message is blocked, player is muted for the set duration |
AUTO_KICK |
Player is kicked immediately |
Escalation is per-player within a 24-hour window. Set a threshold and Gavelry will switch to a harsher action after that many offenses.
Case System
Every filter hit creates a case saved to an SQLite database. Each case includes:
- The flagged message and which category caught it
- 20 messages of chat before and after it
- The player's past offense history
- A log of all staff actions taken on it
Staff can open the case list in-game with /gavelry cases or /gvl cases and handle everything from there.
Pattern Lists
Word lists are plain .txt files, one term per line. Gavelry ships with built-in lists for all four categories. You can also point a category at a remote URL and Gavelry will fetch it on startup and on each reload.
Two files let you adjust any category without editing the base lists:
custom-additions.txt adds terms to every category
custom-exclusions.txt removes terms from every category
Run /gvl reload to pick up changes without restarting.
Integrations
Discord Webhook - new cases get posted to a staff channel. You can set a minimum severity so only serious violations (like slurs or advertising) are sent.
LuckPerms Trusted Groups - players in trusted groups skip profanity and spam checks but are still filtered for slurs.
Commands
| Command |
What it does |
/gvl reload |
Reload config and pattern lists |
/gvl cases |
Open the case review GUI |
/gvl stats |
View filter statistics |
/gvl mute <player> <duration> <reason> |
Mute a player manually |
/gvl unmute <player> |
Unmute a player |
/gvl history <player> |
View a player's past cases |
All commands work with both /gavelry and /gvl.
gavelry.bypass is not given to OPs by default. Server owners are filtered the same as everyone else unless the permission is granted explicitly.
Credits
LEAD DEVELOPER
(@efegorkemefe) arikutov2
Thank you to everyone who tested and reported bugs.
评论 0
登录后参与评分
还没有评论,来抢沙发吧