AntiAFK - The Performance AFK Solution

<div align="center"> <img width="55%" src="https://i.imgur.com/QK50QUt.png" alt="AntiAFK Banner"> ## Smart, Performance-Focused, and Comprehensive AFK Management System !(https://img.shields.io/badge/License-MIT-yellow.svg) !(https://img.shields.io/badge/Java-8+-blue.svg) !(https://img.shields.io/badge/API-Spigot_1.13+-orange.svg) </div> --- <div align="center"> **AntiAFK** is a next-generation management tool designed for modern Minecraft servers where standard AFK timers fall short. Its primary goal is not only to detect AFK players but also to proactively prevent the most complex bots and attempts to exploit AFK detection. With a design that prioritizes server performance, it operates unnoticed even on the busiest servers. <details> <summary>Visuals</summary> Orbital Detection System (Behavior Analysis) <details> <summary>Orbital Detection System visuals.</summary> <img src="https://i.imgur.com/JfUVizh.gif" alt="Orbital Detection System 1"> <img src="https://i.imgur.com/FeHWuth.gif" alt="Orbital Detection System 2"> </details> Repeating Pointless Movements Continuously in the Same Block (Pointless Activity Analysis) <details> <summary>Pointless Activity System visuals.</summary> <img src="https://i.imgur.com/MdHmYiN.gif" alt="Pointless Activity System 1"> <img src="https://i.imgur.com/1gkH9CF.gif" alt="Pointless Activity System 2"> </details> GUI Display: <details> <summary>GUI System images.</summary> <img src="https://i.imgur.com/QHWL44L.gif" alt="GUI System"> </details> </details> </div> --- <div align="center"> # ✨ Key Features ✨ </div> ### **🧠 "Learning Mode": Intelligent Pattern Recognition** Leveraging machine learning principles, Learning Mode detects and counteracts sophisticated AFK bots that follow predefined movement patterns or routes. This system goes beyond simple activity checks to analyze how players move over time. A highly optimized, asynchronous task continuously compares the recent movements of all online players against a library of known bot patterns using the Dynamic Time Warping (DTW) algorithm, which effectively compares two movement sequences even if they are performed at different speeds. * **Asynchronous Pattern Analysis:** A custom-built task runs entirely off the main server thread to perform computationally intensive DTW comparisons, ensuring zero server lag. * **High-Performance Design:** Implements object pooling (Apache Commons Pool2) to significantly reduce garbage collection overhead and uses a lock-free queue to safely pass data between threads. * **Comprehensive Pattern Management:** A new command suite, `/antiafk pattern`, gives you full control to record, list, and manage bot patterns. * **Dual Serialization Formats:** Patterns can be saved in human-readable JSON (for debugging) or a highly efficient binary Kryo format for optimal performance. ### **Multi-Layered Detection Architecture** AntiAFK applies a four-layered analysis to detect AFK behavior and bots that mimic it: * **Layer 1: Classic Activity Monitoring:** Monitors over 10 basic actions, including movement, chat, inventory, and world interaction. * **Layer 2: Pointless Actions Analysis:** Counts non-movement actions repeated by the player while staying at the same block coordinates. When the threshold is exceeded, these actions are prevented from resetting the AFK timer. * **Layer 3: Macro and Exploit Detection:** Detects clicking patterns that are too consistent to be human (Auto-Clicker) and exploits involving very fast position changes using portals/commands. * **Layer 4: Asynchronous Behavioral Analysis:** Analyzes players' movement trajectories asynchronously, catching even bots that follow the most complex trajectories along a specific route. ### **“Turing Test” (Captcha Protection)** When suspicious behavior is detected, AntiAFK challenges the player: * **Smart Triggers:** Automatically activate based on suspicious trajectory repetition or pointless action counts. * **Flexible Question-Answer System:** Asks the player a random question from `questions.yml` to verify they are human. Supports multiple correct answers for each question. * **Suspicious Mode:** While a test is active, the bot's movements or clicks cannot reset the AFK timer, making it impossible for bots to bypass the test. * **Customizable Penalties:** You can define custom commands such as `kick` or `ban` for players who fail the test. ### **Graduated Penalty and Record System** Provides a fair and effective penalty system: * **Persistent Data Storage (SQLite):** Players' entire AFK history (number of penalties, total AFK time, captcha statistics) is permanently stored on the server. * **Graduated Penalties:** For repeated AFK behavior, you can configure actions (warning, kick, temporary ban, etc.) that increase in severity based on the number of penalties. * **Automatic Penalty Reset:** The records of players who have not caused problems for a long time are automatically cl

## Smart, Performance-Focused, and Comprehensive AFK Management System

!(https://img.shields.io/badge/License-MIT-yellow.svg) !(https://img.shields.io/badge/Java-8+-blue.svg) !(https://img.shields.io/badge/API-Spigot_1. 13+-orange.svg)

AntiAFK is a next-generation management tool designed for modern Minecraft servers where standard AFK timers fall short. Its primary goal is not only to detect AFK players but also to proactively prevent the most complex bots and attempts to exploit AFK detection. With a design that prioritizes server performance, it operates unnoticed even on the busiest servers.

Visuals

Orbital Detection System (Behavior Analysis)

Orbital Detection System visuals.

Repeating Pointless Movements Continuously in the Same Block (Pointless Activity Analysis)

Pointless Activity System visuals.

GUI Display:

GUI System images.

# ✨ Key Features ✨

### 🧠 "Learning Mode": Intelligent Pattern Recognition Leveraging machine learning principles, Learning Mode detects and counteracts sophisticated AFK bots that follow predefined movement patterns or routes. This system goes beyond simple activity checks to analyze how players move over time. A highly optimized, asynchronous task continuously compares the recent movements of all online players against a library of known bot patterns using the Dynamic Time Warping (DTW) algorithm, which effectively compares two movement sequences even if they are performed at different speeds. Asynchronous Pattern Analysis: A custom-built task runs entirely off the main server thread to perform computationally intensive DTW comparisons, ensuring zero server lag. High-Performance Design: Implements object pooling (Apache Commons Pool2) to significantly reduce garbage collection overhead and uses a lock-free queue to safely pass data between threads. Comprehensive Pattern Management: A new command suite, `/antiafk pattern`, gives you full control to record, list, and manage bot patterns. Dual Serialization Formats: Patterns can be saved in human-readable JSON (for debugging) or a highly efficient binary Kryo format for optimal performance.

### Multi-Layered Detection Architecture AntiAFK applies a four-layered analysis to detect AFK behavior and bots that mimic it: Layer 1: Classic Activity Monitoring: Monitors over 10 basic actions, including movement, chat, inventory, and world interaction. Layer 2: Pointless Actions Analysis: Counts non-movement actions repeated by the player while staying at the same block coordinates. When the threshold is exceeded, these actions are prevented from resetting the AFK timer. Layer 3: Macro and Exploit Detection: Detects clicking patterns that are too consistent to be human (Auto-Clicker) and exploits involving very fast position changes using portals/commands. Layer 4: Asynchronous Behavioral Analysis: Analyzes players' movement trajectories asynchronously, catching even bots that follow the most complex trajectories along a specific route.

### “Turing Test” (Captcha Protection) When suspicious behavior is detected, AntiAFK challenges the player: Smart Triggers: Automatically activate based on suspicious trajectory repetition or pointless action counts. Flexible Question-Answer System: Asks the player a random question from `questions.yml` to verify they are human. Supports multiple correct answers for each question. Suspicious Mode: While a test is active, the bot's movements or clicks cannot reset the AFK timer, making it impossible for bots to bypass the test. Customizable Penalties: You can define custom commands such as `kick` or `ban` for players who fail the test.

### Graduated Penalty and Record System Provides a fair and effective penalty system: Persistent Data Storage (SQLite): Players' entire AFK history (number of penalties, total AFK time, captcha statistics) is permanently stored on the server. Graduated Penalties: For repeated AFK behavior, you can configure actions (warning, kick, temporary ban, etc.) that increase in severity based on the number of penalties. * Automatic Penalty Reset: The records of players who have not caused problems for a long time are automatically cl