AFK Terminator — smart AFK farm detector for Minecraft

AFK Terminator: Smart AFK Machine Detection for Minecraft

Running a Minecraft server comes with its fair share of headaches, and one of the most persistent ones is dealing with players who game the AFK system. You know the type: they set up contraptions that keep their character moving or active, letting them rack up playtime rewards, claim land, or hold server slots without actually being at their keyboard. This is where AFK Terminator: Smart AFK Machine Detection for Minecraft steps in. It is a specialized server-side tool designed to identify, log, and respond to automated AFK farming, giving server administrators a robust way to enforce fair play. This add-on does not just flag suspicious behavior; it provides a comprehensive suite of detection algorithms, customizable punishments, and administrative tools to keep your server's economy and player base healthy.

The core philosophy of this tool is that it is not an anti-cheat in the traditional sense, but rather a dedicated watchdog for inactivity fraud. It is built to understand the difference between a player who is genuinely idle and one who has engineered a machine to simulate activity. For server owners who have spent hours chasing down exploiters, this tool offers a practical, configurable solution that integrates directly into the server's workflow.

Core Detection Capabilities: How It Spots the Cheaters

The intelligence behind AFK Terminator lies in its pattern recognition. Instead of relying on simple movement checks, the plugin analyzes player actions against a library of known AFK farm designs. It looks for repetitive, cyclic, and unnatural movement patterns that indicate a machine is doing the work, not a human. The detection is not instantaneous; it requires the behavior to be sustained and cyclical, which significantly reduces false positives. A player who happens to be circling a mob farm for a few minutes will not trigger an alert, but a player who has been on a rail loop for hours certainly will.

Recognized AFK Farm Patterns

The plugin is capable of identifying a wide array of common and complex farm mechanics. This includes, but is not limited to:

• Circular rail systems where a player rides a minecart in a loop.
• Water streams that push the player in circles or up and down repeatedly.
• Constant jumping, including setups that use pistons to bounce the player.
• Piston-based pushers and door randomizers that keep the player moving.
• Vertical flight in creative mode, where a player simply holds the space bar.
• Automated fishing farms that cast and reel continuously.
• Riding saddled pigs, with or without a carrot on a stick, in a loop.
• More advanced setups involving arrow dispensers, block-breaking machines, and vine farms.
• Water flows over fences and other less common, but still detectable, schemes.

By monitoring for these specific signatures, the plugin ensures that even the most creative attempts to fool the server are eventually caught. The key differentiator is the analysis of duration and repetition; a single occurrence is ignored, but a persistent pattern is flagged.

Flexible Punishment System: You Decide the Consequence

Once a violation is confirmed, the server administrator has full control over the response. All settings are managed in the config.yml file, allowing for a tailored approach that matches the server's rules and playstyle. The available actions range from a simple log entry to complete destruction of the AFK machine and a permanent ban.

Available Punishment Actions

• NOTHING: This option only records the event to the log file, with no in-game action taken. It is useful for monitoring without disruption.
• LAVA: A stream of lava is spawned at the player's location, quickly destroying the machine and potentially harming the player.
• TNT: An explosion is triggered, obliterating the machine and the surrounding area. Caution is advised on PvP servers, as players might intentionally build AFK farms near enemy bases to trigger this and cause destruction.
• KICK: The offending player is immediately disconnected from the server.
• KILL: The player's character is instantly killed in-game.
• COMMAND: Executes any console command defined by the administrator. The default is ban [player]. Multiple commands can be chained in a single line using the /n separator. This allows for complex sequences, such as first deducting playtime via a plugin like OnTime and then issuing a ban.
• SPAWNMOB: Summons one or more mobs directly on top of the player, which can be used for creative or punitive purposes.

This flexibility is a major selling point. A server focused on a friendly, casual community might opt for a simple kick, while a competitive server with a valuable economy might choose the TNT option to destroy the cheating apparatus and send a clear message.

Administrative Notifications and Mail System

Staying informed about rule violations is crucial. AFK Terminator offers three distinct channels for notifying staff members when a machine is detected, ensuring that moderators are always in the loop.

Notification Channels

• Console Log: A message is printed to the server console immediately upon detection.
• In-Game Chat: A customizable message is sent to all players with the afkTerminator.notify permission.
• In-Game Mail: Players with the afkTerminator.mailReceive permission receive a message via the server's mail system. The plugin is compatible with Essentials Mail by default. The mail text mirrors the chat notification and is also editable in the config.

To prevent the mail recipient list from becoming bloated with inactive players, the plugin automatically removes anyone who has not logged in for a specified number of days. If that player returns, they are re-added to the list, provided they still have the required permission. The command used to send the mail is also configurable, offering another layer of customization.

Preventing Auto-Reconnect and Login Delays

Some players use client-side mods that automatically reconnect them to the server immediately after a kick. This can be a nuisance, as it bypasses the punishment and allows them to continue their scheme. AFK Terminator addresses this with a smart login delay system. After a player logs out for any reason, the plugin enforces a configurable wait time before they can rejoin. If a player attempts to reconnect multiple times in quick succession, the delay increases exponentially. If they exceed a set limit of attempts, a defined action, such as a ban, can be triggered.

This feature is a powerful deterrent. It breaks the cycle of instant reconnection and forces the player to wait, making the AFK farm unprofitable. Players with the afkTerminator.loginDelayExcluded permission are exempt from this restriction, which is useful for staff members or trusted players who need immediate access.

Permissions and Vault Integration

The plugin utilizes a standard permission system, which requires the Vault plugin to be installed if you want to manage permissions. This is optional, but highly recommended for servers with multiple ranks. The key permissions are:

• afkTerminator.excluded: The player is exempt from punishments, but their actions are still logged.
• afkTerminator.admin: Grants access to the /afkt reload command to reload the configuration.
• afkTerminator.notify: Allows the player to receive in-game chat notifications.
• afkTerminator.mailReceive: Allows the player to receive in-game mail notifications.
• afkTerminator.loginDelayExcluded: Exempts the player from the login delay.

This granular control allows server owners to designate specific moderators to handle AFK issues without giving them full administrative powers.

Installation and Configuration Guide

Getting this tool up and running is straightforward, designed for quick deployment. For those looking to test it quickly or build a custom server setup, using a dedicated launcher can streamline the process of installing and testing plugins alongside other tools.

Step-by-Step Setup

1. Place the AfkTerminator.jar file into your server's plugins folder.
2. If you plan to use permissions, add Vault.jar to the same directory.
3. Restart the server or run /reload.
4. Edit the plugins/AfkTerminator/config.yml file to set your preferred punishment types, message texts, and delay durations.
5. Run /afkt reload or restart the server again to apply the changes.

All detection events are recorded in the log file located at /plugins/afkTerminator/AfkTerminator.log. The plugin does not manage the size of this file, so administrators should periodically clear it manually to avoid disk space issues. This tool is compatible with various Minecraft versions and server loaders, making it a versatile addition to any modded or vanilla setup. To get started, you can easily download AFK Terminator: Smart AFK Machine Detection for Minecraft from reputable plugin repositories. When you search for AFK Terminator: Smart AFK Machine Detection for Minecraft for Minecraft, you will find it is a lightweight, dependency-light plugin that is ready to work out of the box.

Developer API for Extended Use

For server owners who like to build custom solutions, AFK Terminator offers a public API. This allows other plugins to hook into its detection engine and use the data in their own algorithms. This is particularly useful for creating a comprehensive anti-AFK system or integrating the detection data into custom statistics and monitoring dashboards. The API documentation is available on the official plugin page, providing developers with the necessary tools to extend the plugin's functionality.

Final Thoughts on Server Protection

AFK Terminator: Smart AFK Machine Detection for Minecraft is more than just a simple anti-AFK plugin; it is a comprehensive management tool for maintaining server integrity. Its ability to detect dozens of farm types, combined with a highly customizable punishment system, gives administrators the power to create a fair and enjoyable environment. The additional features, such as mail notifications, auto-reconnect blocking, and a developer API, make it an invaluable asset for serious server projects. By understanding how to install and configure this plugin, you can effectively eliminate the unfair advantages gained by automated farming and ensure that playtime rewards are earned by genuine players. It is a robust, flexible, and essential tool for any server owner committed to fair play.