AntiAFK - The Performance AFK Solution

AntiAFK — это система следующего поколения для мониторинга активности игроков и предотвращения эксплуатации механизмов AFK с помощью многоуровневого анализа поведения.

AntiAFK — инструмент управления для современных серверов, где стандартных таймеров недостаточно. Его основная цель заключается не только в обнаружении AFK-игроков, но и в превентивном блокировании сложных ботов и попыток обхода систем проверки активности.

✨ Key Features ✨

🧠 "Learning Mode": Intelligent Pattern Recognition
Используя принципы машинного обучения, режим обучения обнаруживает продвинутых ботов, следующих по заданным маршрутам. Система анализирует перемещения игроков во времени, сравнивая их с библиотекой известных паттернов с помощью алгоритма Dynamic Time Warping (DTW), который позволяет сопоставлять последовательности движений даже при разной скорости выполнения.

• Асинхронный анализ паттернов: вычислительно сложные сравнения DTW выполняются в отдельном потоке, обеспечивая отсутствие лагов на основном сервере.
• Высокопроизводительная архитектура: использование объектного пулинга (Apache Commons Pool2) снижает нагрузку на сборку мусора, а блокировки отсутствуют благодаря использованию lock-free очереди.
• Управление паттернами: команда /antiafk pattern позволяет записывать, просматривать и управлять паттернами ботов.
• Двойная сериализация: паттерны можно сохранять в читаемом формате JSON (для отладки) или в эффективном бинарном формате Kryo для оптимизации.

Multi-Layered Detection Architecture
AntiAFK применяет четырехслойный анализ для обнаружения AFK-поведения и ботов, имитирующих его:

• Layer 1: Classic Activity Monitoring — отслеживание более 10 базовых действий, включая движение, чат, инвентарь и взаимодействие с миром.
• Layer 2: Pointless Actions Analysis — подсчет повторяющихся действий без перемещения в одной точке. При превышении порога такие действия перестают сбрасывать таймер AFK.
• Layer 3: Macro and Exploit Detection — выявление слишком стабильных паттернов кликов (Auto-Clicker) и аномально быстрых изменений позиции через порталы или команды.
• Layer 4: Asynchronous Behavioral Analysis — анализ траекторий движения в отдельных потоках для поимки ботов со сложными маршрутами.

“Turing Test” (Captcha Protection)
При обнаружении подозрительного поведения AntiAFK инициирует проверку игрока:

• Smart Triggers: автоматическое включение при повторении траекторий или избытке бессмысленных действий.
• Гибкая система вопросов: проверка через случайные вопросы из questions.yml с поддержкой нескольких правильных ответов.
• Suspicious Mode: во время теста действия бота или клики не могут сбросить таймер AFK.
• Настраиваемые наказания: возможность указать команды, такие как kick или ban, для тех, кто не прошел тест.

Graduated Penalty and Record System
Плагин обеспечивает справедливое распределение наказаний с использованием постоянного хранения данных в SQLite. История AFK каждого игрока, количество наказаний, общее время AFK и статистика капч сохраняются на сервере.

• Градуированные наказания: действия (предупреждение, кик, временный бан и т.д.) могут увеличиваться в строгости в зависимости от количества нарушений.
• Автоматический сброс записей: данные игроков, которые долгое время не нарушали правила, автоматически очищаются через заданный период.

🌍 Full Internationalization (i18n) Support
Все сообщения системы, ошибки и команды переведены на множество языков. Глобальный язык консоли настраивается в config.yml через параметр lang. Для изменения сообщений игрока необходимо заменить messages.yml файлом из набора официальных переводов (поддерживаются русский, английский, испанский, немецкий, французский, турецкий и польский).

Comprehensive Management and Configuration
Предоставляет полный контроль владельцам сервера через основную команду /antiafk:

• panel: открывает полнофункциональный GUI для управления плагином в игре.
• reload: перезагружает все конфигурационные файлы.
• check : запрашивает детальную запись и текущий статус игрока.
• top: отображает таблицы лидеров AFK.
• list: список игроков, находящихся в AFK.
• pattern: управление паттернами в режиме обучения.

🚀 Performance

AntiAFK разработан с использованием современных техник для минимизации влияния на сервер:

• Асинхронные операции: тяжелые вычисления (алгоритм DTW, анализ поведения) и все взаимодействия с базой данных происходят вне основного потока сервера.
• Умное кэширование (Caffeine): часто запрашиваемые данные (статистика игроков, настройки) хранятся в высокопроизводительном кэше.
• Распределенная нагрузка: периодические задачи равномерно распределяются на 20 тиков в течение одной секунды, предотвращая скачки нагрузки.

Performance Profile (Spark Analysis)
Тестовая среда: Paper 1.19.4, 1 онлайн-игрок, стандартная нагрузка сервера.

// Server's overall idle rate (higher is better)
Server thread: 100.00%
└── net.minecraft.server.MinecraftServer.waitUntilNextTick(): 85.37%

// Plugin's total impact on the main thread
AntiAFK (v1.0.2)
└── Server thread: 0.24%
├── com.bentahsin.antiafk.tasks.AFKCheckTask.run(): 0.18%
├── com.bentahsin.antiafk.listeners.handlers.PlayerMovementListener.onPlayerMove(): 0.04%
└── Other (Commands, GUI, Captcha): 0.02%

Анализ: сервер проводит более 85% времени в режиме ожидания, что указывает на отсутствие негативного влияния на здоровье сервера. Общее воздействие всех компонентов плагина на основной поток составляет всего ~0.24%, что является статистически незначительным значением.

🔗 Integrations and Installation

• WorldGuard: определение различных длительностей AFK и действий для конкретных зон (арены, рынки, комнаты AFK).
• PlaceholderAPI: передача динамических данных, таких как %antiafk_tag% и %antiafk_reason%, другим плагинам.
• ProtocolLib: расширенные возможности взаимодействия с GUI, включая ввод текста.

Установка:

1. Скачайте последнюю версию.
2. Поместите .jar файл в папку plugins вашего сервера.
3. Запустите сервер для генерации файлов конфигурации (config.yml, messages.yml, questions.yml, playerdata.db).
4. Настройте файлы и используйте команду /antiafk reload.