Autonomous Potential Violation Eradicator (APVE)
作者 / Автор: blackgeyer | 版本 / Версия: 1.4.5 | 许可证 / Лицензия: GPLv3
? 插件展示 / Видео с демонстрацией: 在 YouTube 上观看
文档:
Discord:
?? English
如果你正在使用 APVE,那就再也不用担心聊天中出现广告、成人内容、侮辱性言论以及其他乱七八糟的东西了!
APVE:一款高性能、完全异步的 Minecraft 聊天管理插件。旨在以零主线程开销保持服务器聊天环境的清洁。由 PacketEvents、Aho-Corasick、RE2J(用于高优化模式匹配)以及 模糊匹配 系统提供支持。
插件工作展示:
? 核心功能与架构
- 三阶段模式匹配 ($O(N)$ + 模糊回退 + 自定义 RE2J): 单词并非仅通过 100% 精确相等进行严格检查。插件首先使用极速的 Aho-Corasick 字符串匹配算法。如果在字典中未找到精确匹配,则会自动触发 模糊匹配,将单词相似度与字典模式进行比较,从而拦截绕过手段、故意拼写错误和修改过的字母。自定义 RE2J 模式匹配: 如果前两个阶段未能检测到违规,你始终可以使用
re2j编写自己的自定义正则表达式来增强过滤效果。得益于 $O(N)$ 线性时间复杂度和内置的 ReDoS 攻击防护,它们允许你在不危及服务器性能的前提下,精准捕捉复杂的绕过方案。 - 100% 异步 Netty 拦截: 在网络层拦截并丢弃聊天数据包,使其无法到达服务器的主线程。
- 多引擎文本规范化: 自动剥离同形异义字、Unicode 变体、重音符号以及 Leetspeak 绕过手段。规范化引擎具备三种不同的操作模式:
- 粗暴模式 (Rude Mode): 激进地剥离所有数字和特殊字符(如
|、?等),以隔离纯文本用于核心字典检查。 - 智能模式 (Smart Mode): 智能解码 Leetspeak 和符号,将
|或!等字符替换为其预期的字母等效项。 - 消极模式 (Despondent Mode): 保留数字和特殊字符而不进行转换,专门设计用于检测域名或服务器地址等模式(例如
someserver2024 xyz)。
- 粗暴模式 (Rude Mode): 激进地剥离所有数字和特殊字符(如
- 离线处罚流水线: 自动发出警告并执行可配置的处罚命令。
- 命令拦截: APVE 还会拦截并检查
/whisper或/msg等命令。
? 安装指南
- 将 PacketEvents(Spigot/Paper 版本,非 Bungee/Velocity 代理版本)安装到
/plugins/目录中。 - 将你的主要处罚引擎(例如 EssentialsX、AdvancedBan 等)安装到
/plugins/目录中。 - 将
A.P.V.E.jar放入/plugins/目录。 - 重启服务器。
⚙️ 技术兼容性
- 核心: 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)。
- Rude Mode(粗鲁模式): 激进地移除所有数字和特殊符号(如
-
自动离线处罚: 自动记录警告并执行可配置的处罚命令。
-
命令拦截: APVE 还会拦截并检查私人消息和通信命令(例如
/whisper、/msg等)。
? 安装
- 将插件 PacketEvents(Spigot/Paper 版本,非 Proxy/Bungee/Velocity 版本)放入
/plugins/文件夹。 - 将处罚插件(例如 EssentialsX、AdvancedBan 等)放入
/plugins/文件夹。 - 将文件
A.P.V.E.jar放入/plugins/文件夹。 - 重启服务器。
⚙️ 兼容性
- 核心: 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 |
Autonomous Potential Violation Eradicator (APVE)
Author / Автор: blackgeyer | Version / Версия: 1.4.5 | License / Лицензия: GPLv3
? Plugin Showcase / Видео с демонстрацией: Watch on YouTube
Documentation:
Discord:
?? English
Forget about ads, sharing adult content, insults, and other nonsense in the chat if you're using APVE!
APVE: High-performance, fully asynchronous Minecraft chat moderation plugin. Designed to keep your server chat clean with zero main-thread overhead. Powered by PacketEvents, Aho-Corasick, RE2J for high-optimized patterns and Fuzzy Matching system.
Plugin work showcase:
? Key Features & Architecture
- Three-Stage Pattern Matching ($O(N)$ + Fuzzy Fallback + Custom RE2J): Words are not strictly checked by 100% exact equality alone. The plugin first uses lightning-fast Aho-Corasick string matching. If an exact match is not found in the dictionary, it automatically triggers Fuzzy Matching to compare the word's similarity against dictionary patterns, catching bypasses, intentional typos, and modified letters. Custom RE2J Pattern Matching: If the first two stages fail to detect a violation, you can always write your own custom regular expressions using
re2jto enhance filtration. Thanks to $O(N)$ linear time complexity and built-in protection against ReDoS attacks, they allow you to precisely catch complex bypass schemes without risking server performance. - 100% Asynchronous Netty Interception: Intercepts and drops chat packets at the network layer before they reach the server's main thread.
- Multi-Engine Text Normalization: Automatically strips homoglyphs, Unicode variations, diacritics, and leetspeak bypasses. The normalization engine features three distinct operating modes:
- Rude Mode: Aggressively strips all digits and special characters (such as
|,?, etc.) to isolate pure text for core dictionary checks. - Smart Mode: Intelligent leetspeak and symbol decoding that substitutes characters like
|or!with their intended alphabetic equivalents. - Despondent Mode: Preserves digits and special characters without transformation, designed specifically to detect patterns like domain names or server addresses (e.g.,
someserver2024 xyz).
- Rude Mode: Aggressively strips all digits and special characters (such as
- Offline Punishment Pipeline: Issues warnings and executes configurable punishment commands automatically.
- Commands interception: APVE also intercepts and checks the commands like
/whisperor/msg.
? Installation
- Install PacketEvents (Spigot/Paper version, NOT Bungee/Velocity proxy version) into
/plugins/. - Install your primary punishment engine (e.g., EssentialsX, AdvancedBan, etc.) into
/plugins/. - Place
A.P.V.E.jarinto/plugins/. - Restart the server.
⚙️ Technical Compatibility
- Cores: Paper, Purpur, Spigot, etc. (any standard Bukkit-based core) or Folia.
- Minecraft Versions: 1.20.5 – 26.x+
- Java: 21
⚠️ Important Usage Notes
- Configure
config.ymlbefore deploying to production to set up punishment command templates and avoid false positives. - Due to the internal normalization pipeline, all banned word patterns in
config.ymlmust be entered using Latin characters only (e.g., useshlyuhainstead ofшлюха). Refer todocumentation.txtfor details.
? Commands & Permissions
| Command | Description | Permission | Default |
|---|---|---|---|
/apve |
Base command for plugin management. | apve.use |
OP |
/apve reload |
Reloads plugin configuration. | apve.reload |
OP |
/apve warns show {player} |
Displays current warning count for a player. | apve.warns.show |
OP |
/apve warns remove {player} {amount} |
Removes a specified number of warnings from a player. | apve.warns.remove |
OP |
/apve warns clear {player} |
Resets all warnings for a player. | apve.warns.clear |
OP |
/apve notify toggle |
Toggles staff alerts for detected violations. | apve.notify.toggle |
OP |
/apve check {string} |
Normalizes and tests a string against filter rules. | apve.check |
OP |
/apve help |
Displays available commands and usage info. | apve.help |
OP |
? Additional Permissions & Immunity Nodes
| Permission | Description | Default |
|---|---|---|
apve.violation.notify |
Allows receiving real-time chat notifications about player violations. | False |
apve.insult.immune |
Grants immunity against general insult detections. | False |
apve.fam.insult.immune |
Grants immunity against family insult detections. | False |
apve.caps.immune |
Grants immunity against upper-case (caps) filter. | False |
apve.spam.immune |
Grants immunity against spam filter. | False |
apve.adult.content.immune |
Grants immunity against adult content filter. | False |
apve.social.immune |
Grants immunity against social media links filter. | False |
apve.advertisement.immune |
Grants immunity against advertisement and external resource sharing. | False |
apve.staff.insult.immune |
Grants immunity against staff insult detections. | False |
?? Русский
Забудьте о рекламе, взрослом контенте, оскорблениях и прочей ереси в чате, если вы используете APVE!
APVE: Высокопроизводительный асинхронный плагин модерации чата. Поддерживает чистоту сервера в автоматическом режиме с нулевой нагрузкой на главный поток сервера. Работает на базе PacketEvents, алгоритма Aho-Corasick, библиотеки RE2J для высокооптимизированных паттернов и интеллектуальной системы Fuzzy Matching.
? Архитектурные преимущества
-
Трёхэтапная проверка ($O(N)$ + Fuzzy Fallback + Кастомный RE2J): Проверка слов не ограничивается строго 100% точным совпадением. Плагин сначала выполняет ультрабыстрый поиск через алгоритм Ахо-Корасик. Если точное совпадение в словаре не найдено, автоматически включается Fuzzy Matching (нечёткое сравнение), которое сопоставляет степень схожести слова с паттернами из словаря, отлавливая обходы, опечатки и подмену букв. Кастомные RE2J паттерны: Если первые два этапа не смогли обнаружить нарушение, вы всегда можете написать свои кастомные регулярные выражения на базе
re2j. Благодаря линейной сложности $O(N)$ и встроенной защите от ReDoS-атак, они позволяют точечно отлавливать сложные схемы обхода фильтра без риска для производительности сервера. -
Асинхронный перехват Netty: Фильтрация и сброс запрещённых пакетов происходят на сетевом уровне до их обработки главным потоком сервера.
-
Многорежимный нормализатор текста: Автоматически нейтрализует обходы через символы-омоглифы, вариации Unicode, диакритику и Leetspeak. Движок нормализации имеет три различных режима работы:
-
Rude Mode: Агрессивно вырезает все цифры и спецсимволы (такие как
|,?и т.д.), изолируя чистый текст для базовых проверок по словарям. -
Smart Mode: Интеллектуальное декодирование Leetspeak и символов, заменяющее знаки вроде
|или!на аналогичные по смыслу буквы. -
Despondent Mode: Сохраняет цифры и спецсимволы без изменений. Режим специально предназначен для детекта доменных имён и адресов серверов (например,
someserver2024 xyz). -
Автоматические оффлайн-наказания: Автоматический учёт предупреждений и исполнение настраиваемых команд наказаний.
-
Перехват команд: APVE также перехватывает и проверяет личные сообщения и команды коммуникации (например,
/whisper,/msgи другие).
? Установка
- Поместите плагин PacketEvents (Spigot/Paper версию, НЕ Proxy/Bungee/Velocity) в папку
/plugins/. - Поместите плагин наказаний (например, EssentialsX, AdvancedBan и т.д.) в папку
/plugins/. - Загрузите файл
A.P.V.E.jarв папку/plugins/. - Перезапустите сервер.
⚙️ Совместимость
- Ядра: 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} {число} |
Снимает указанное количество предупреждений. | apve.warns.remove |
OP |
/apve warns clear {player} |
Полностью очищает предупреждения игрока. | apve.warns.clear |
OP |
/apve notify toggle |
Переключает получение уведомлений о нарушениях. | apve.notify.toggle |
OP |
/apve check {строка} |
Проверяет и нормализует строку на предмет нарушений. | 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 |
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 APVE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
我终于完成了 APVE v1.4.5 的新版本更新。此前我意识到,简单的归一化——例如盲目地尝试用符号替换 Leet Speak(网络黑话),或者单纯去除数字中的特殊符号——只会加剧聊天过滤的问题,并开辟绕过系统的新途径。为了解决这个问题,我将归一化分为三种方法:Rude、Smart 和 Despondent,每种方法各自封堵了其对应的漏洞。Rude 防止滥用者通过在非法消息的字符间插入数字和其他 Leet Speak 数字来绕过过滤器;Smart 拦截诸如 “he||0” 之类的变体;Despondent 则将包含数字的广告词保留在一种适合通过 Aho-Corasick 算法进行验证的状态。此外,我还认为标准的 java.util.regex 过于脆弱且缓慢,因此我切换到了 re2j。是的,我必须不断与 YAML 解析器斗争,以防止它将我的正则表达式模式序列化为二进制格式(顺便提一下,我在配置中添加了支持自定义 re2j 模式的能力,以实现基于区块的强制执行)。虽然 re2j 因为缺少后行断言(lookbehind)和先行断言(lookahead)而稍显薄弱,但为了防范 ReDoS(正则表达式拒绝服务攻击),这一切都是值得的。
我通过 FoliaLib 添加了对 Folia 的支持。无需单独下载——该库已包含在最终的 JAR 文件中。我还略微调整了插件的文件夹结构:现在,所有文件不再集中存放在一个文件夹中,而是按用途进行分类组织。此外,我将 NetworkChatInterceptor 拆分为四个模块,以防止其变得难以维护。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧