APVE

插件

· 作者 blackgeyer

适用于 Paper/Spigot 的超快异步 Minecraft 聊天过滤器、反垃圾信息、脏话屏蔽及链接拦截器。高级数据包聊天审核功能。

0 本站下载 0 关注 更新于 3 周前

需要前置:PacketEvents

最新 1.4.5 · 26.3 · Bukkit / Folia

一键开服(送7天)

Autonomous Potential Violation Eradicator (APVE)

作者 / Автор: blackgeyer | 版本 / Версия: 1.4.5 | 许可证 / Лицензия: GPLv3
? 插件展示 / Видео с демонстрацией: 在 YouTube 上观看

文档:

Discord:


?? English

如果你正在使用 APVE,那就再也不用担心聊天中出现广告、成人内容、侮辱性言论以及其他乱七八糟的东西了!

APVE:一款高性能、完全异步的 Minecraft 聊天管理插件。旨在以零主线程开销保持服务器聊天环境的清洁。由 PacketEvents、Aho-Corasick、RE2J(用于高优化模式匹配)以及 模糊匹配 系统提供支持。

插件工作展示:

APVE Demo

? 核心功能与架构

  • 三阶段模式匹配 ($O(N)$ + 模糊回退 + 自定义 RE2J): 单词并非仅通过 100% 精确相等进行严格检查。插件首先使用极速的 Aho-Corasick 字符串匹配算法。如果在字典中未找到精确匹配,则会自动触发 模糊匹配,将单词相似度与字典模式进行比较,从而拦截绕过手段、故意拼写错误和修改过的字母。自定义 RE2J 模式匹配: 如果前两个阶段未能检测到违规,你始终可以使用 re2j 编写自己的自定义正则表达式来增强过滤效果。得益于 $O(N)$ 线性时间复杂度和内置的 ReDoS 攻击防护,它们允许你在不危及服务器性能的前提下,精准捕捉复杂的绕过方案。
  • 100% 异步 Netty 拦截: 在网络层拦截并丢弃聊天数据包,使其无法到达服务器的主线程。
  • 多引擎文本规范化: 自动剥离同形异义字、Unicode 变体、重音符号以及 Leetspeak 绕过手段。规范化引擎具备三种不同的操作模式:
    • 粗暴模式 (Rude Mode): 激进地剥离所有数字和特殊字符(如 |、? 等),以隔离纯文本用于核心字典检查。
    • 智能模式 (Smart Mode): 智能解码 Leetspeak 和符号,将 | 或 ! 等字符替换为其预期的字母等效项。
    • 消极模式 (Despondent Mode): 保留数字和特殊字符而不进行转换,专门设计用于检测域名或服务器地址等模式(例如 someserver2024 xyz)。
  • 离线处罚流水线: 自动发出警告并执行可配置的处罚命令。
  • 命令拦截: APVE 还会拦截并检查 /whisper 或 /msg 等命令。

? 安装指南

  1. 将 PacketEvents(Spigot/Paper 版本,非 Bungee/Velocity 代理版本)安装到 /plugins/ 目录中。
  2. 将你的主要处罚引擎(例如 EssentialsX、AdvancedBan 等)安装到 /plugins/ 目录中。
  3. 将 A.P.V.E.jar 放入 /plugins/ 目录。
  4. 重启服务器。

⚙️ 技术兼容性

  • 核心: Paper, Purpur, Spigot 等(任何标准的基于 Bukkit 的核心)或 Folia。
  • Minecraft 版本: 1.20.5 – 26.x+
  • Java: 21

⚠️ 重要使用说明

  • 在生产环境部署之前,请先配置 config.yml 以设置处罚命令模板并避免误报。
  • 由于内部存在规范化流程,config.yml 中的所有封禁词模式必须仅使用 拉丁字符 输入(例如,请使用 shlyuha 而不是 шлюха)。详情请参考 documentation.txt。

? 命令与权限

命令 描述 权限 默认值
/apve 插件管理的基础命令。 apve.use OP
/apve reload 重新加载插件配置。 apve.reload OP
/apve warns show {player} 显示玩家当前的警告次数。 apve.warns.show OP
/apve warns remove {player} {amount} 从玩家处移除指定数量的警告。 apve.warns.remove OP
/apve warns clear {player} 重置玩家的所有警告。 apve.warns.clear OP
/apve notify toggle 切换针对已检测违规的管理员警报。 apve.notify.toggle OP
/apve check {string} 对字符串进行规范化并根据过滤规则进行测试。 apve.check OP
/apve help 显示可用命令和使用信息。 apve.help OP

? 额外权限与免疫节点

权限 描述 默认值
apve.violation.notify 允许接收关于玩家违规行为的实时聊天通知。 False
apve.insult.immune 授予免受一般侮辱检测免疫的权利。 False
apve.fam.insult.immune 授予免受亲属侮辱检测免疫的权利。 False
apve.caps.immune 授予免受全大写(caps)过滤器免疫的权利。 False
apve.spam.immune 授予免受垃圾邮件过滤器免疫的权利。 False
apve.adult.content.immune 授予免受成人内容过滤器免疫的权利。 False
apve.social.immune 授予免受社交媒体链接过滤器免疫的权利。 False
apve.advertisement.immune 授予免受广告和外部资源共享过滤器免疫的权利。 False
apve.staff.insult.immune 授予免受工作人员侮辱检测免疫的权利。 False

?? Русский

Забудьте о рекламе, взрослом контенте, оскорблениях и прочей ереси в чате, если вы используете APVE!

APVE:一款高性能的异步聊天管理插件。支持在零主线程负载的情况下自动维护服务器环境纯净。基于 PacketEvents、Aho-Corasick 算法、用于高度优化模式的 RE2J 库以及智能 模糊匹配(Fuzzy Matching) 系统构建。

? 架构优势

  • 三阶段检查 ($O(N)$ + Fuzzy Fallback + 自定义 RE2J): 单词检查不仅限于 100% 精确匹配。插件首先通过 Aho-Corasick 算法执行超快速搜索。如果在字典中未找到精确匹配,将自动启用 模糊匹配(Fuzzy Matching),该功能会将单词与字典中的模式进行相似度比对,从而拦截绕过行为、拼写错误和字母替换。自定义 RE2J 模式: 如果前两个阶段未能检测到违规,您始终可以基于 re2j 编写自定义正则表达式。得益于线性复杂度 $O(N)$ 和内置的 ReDoS 攻击防护,这些模式能够精准捕获复杂的过滤器绕过方案,而不会对服务器性能造成风险。

  • 异步 Netty 拦截: 过滤和丢弃禁止数据包发生在网络层面,早于其被服务器主线程处理。

  • 多模式文本规范化器: 自动中和通过同形字符、Unicode 变体、重音符号和 Leetspeak(黑客语)进行的绕过。规范化引擎具有三种不同的工作模式:

    • Rude Mode(粗鲁模式): 激进地移除所有数字和特殊符号(如 |、? 等),隔离纯文本以进行基本的字典检查。
    • Smart Mode(智能模式): 智能解码 Leetspeak 和符号,将 | 或 ! 等符号替换为含义相似的字母。
    • Despondent Mode(消极模式/保留模式): 保留数字和特殊符号不变。此模式专门用于检测域名和服务器地址(例如 someserver2024 xyz)。
  • 自动离线处罚: 自动记录警告并执行可配置的处罚命令。

  • 命令拦截: APVE 还会拦截并检查私人消息和通信命令(例如 /whisper、/msg 等)。

? 安装

  1. 将插件 PacketEvents(Spigot/Paper 版本,非 Proxy/Bungee/Velocity 版本)放入 /plugins/ 文件夹。
  2. 将处罚插件(例如 EssentialsX、AdvancedBan 等)放入 /plugins/ 文件夹。
  3. 将文件 A.P.V.E.jar 放入 /plugins/ 文件夹。
  4. 重启服务器。

⚙️ 兼容性

  • 核心: Paper, Purpur, Spigot 或任何基于 Bukkit 或 Folia 的核心。
  • Minecraft 版本: 从 1.20.5 到 26.x+
  • Java: 21

⚠️ 重要提示

  • 启动前请配置 config.yml 和处罚命令模板,以排除误报。
  • 由于规范化器的运作,config.yml 中的所有禁止单词模式必须严格使用拉丁字母输入(示例:шлюха -> shlyuha)。详细解析请参阅 documentation.txt。

? 命令与权限

命令 描述 权限 默认值
/apve 插件的基本管理命令。 apve.use OP
/apve reload 重新加载插件配置。 apve.reload OP
/apve warns show {player} 显示玩家的警告数量。 apve.warns.show OP
/apve warns remove {player} {number} 移除指定数量的警告。 apve.warns.remove OP
/apve warns clear {player} 完全清除玩家的警告。 apve.warns.clear OP
/apve notify toggle 切换违规通知的接收状态。 apve.notify.toggle OP
/apve check {string} 检查并规范化字符串以查找违规行为。 apve.check OP
/apve help 显示命令列表及其描述。 apve.help OP

? 额外权限与免疫节点

权限 描述 默认值
apve.violation.notify 允许在聊天中实时接收玩家违规通知。 OP
apve.insult.immune 对普通辱骂行为的处罚免疫。 False
apve.fam.insult.immune 对辱骂亲属行为的处罚免疫。 False
apve.caps.immune 对全大写消息过滤器的免疫。 False
apve.spam.immune 对垃圾信息过滤器的免疫。 False
apve.adult.content.immune 对成人内容(18+)过滤器的免疫。 False
apve.social.immune 对社交媒体传播过滤器的免疫。 False
apve.advertisement.immune 对广告和第三方资源过滤器的免疫。 False
apve.staff.insult.immune 对辱骂管理人员(Staff)行为的处罚免疫。 False

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源