APVE

Autonomous Potential Violation Eradicator (APVE)

Author / Автор: blackgeyer | Version / Версия: 1.4.0 | License / Лицензия: GPLv3
📹 Plugin Showcase / Видео с демонстрацией: Watch on YouTube

Documentation: https://blackgeyer.github.io/APVE/

Discord: https://discord.gg/TvgqnJNKXW

🇬🇧 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 pattern matching, and Fuzzy Matching fallback system.

Plugin work showcase:

🚀 Key Features & Architecture

• Two-Stage Pattern Matching ($O(N)$ + Fuzzy Fallback): 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.
• 100% Asynchronous Netty Interception: Intercepts and drops chat packets at the network layer before they reach the server's main thread.
• Smart Text Normalization: Strips homoglyphs, obfuscated characters, and leetspeak bypasses automatically.
• Offline Punishment Pipeline: Issues warnings and executes configurable punishment commands automatically.

🛠 Installation

1. Install PacketEvents (Spigot/Paper version, NOT Bungee/Velocity proxy version) into /plugins/.
2. Install your primary punishment engine (e.g., EssentialsX, AdvancedBan, etc.) into /plugins/.
3. Place A.P.V.E.jar into /plugins/.
4. 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.yml before 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.yml must be entered using Latin characters only (e.g., use shlyuha instead of шлюха). Refer to documentation.txt for details.

💻 Commands & Permissions

🔑 Additional Permissions & Immunity Nodes

🇷🇺 Русский

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

APVE: Высокопроизводительный асинхронный плагин модерации чата. Поддерживает чистоту сервера в автоматическом режиме с нулевой нагрузкой на главный поток сервера. Работает на базе PacketEvents, алгоритма Aho-Corasick и интеллектуальной системы Fuzzy Matching.

🚀 Архитектурные преимущества

• Двухэтапная проверка ($O(N)$ + Fuzzy Matching): Проверка слов не ограничивается строго 100% точным совпадением. Плагин сначала выполняет ультрабыстрый поиск через алгоритм Ахо-Корасик. Если точное совпадение в словаре не найдено, автоматически включается Fuzzy Matching (нечёткое сравнение), которое сопоставляет степень схожести слова с паттернами из словаря. Это позволяет эффективно ловить обходы, опечатки и намеренно искажённые слова.
• Асинхронный перехват Netty: Фильтрация и сброс запрещённых пакетов происходят на сетевом уровне до их обработки главным потоком сервера.
• Встроенный нормализатор: Автоматически нейтрализует обходы через замену букв (символы-омоглифы, цифры, спецсимволы).
• Автоматические оффлайн-наказания: Автоматический учёт предупреждений и исполнение команд блокировки.

🛠 Установка

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.

💻 Команды и права

🔑 Дополнительные права и узлы иммунитета