Anti AFK + 2.1

Before, failing a check always kicked the player. Now you decide what happens.

◆ Warn, Kick or Run Your Own Command

• Send a warning instead of a kick
• Kick the player - the old behaviour
• Run any command you like (for example a tempban)
• Works for every check: inactivity, farming, macro and command-triggered

The anti-farm check no longer counts every broken block.

◆ Skyblock Friendly

• You choose which blocks count (cobblestone, stone, ores...)
• Normal building and mining of other blocks is never flagged
• No more false alarms while placing or building blocks

◆ Works With SuperiorSkyblock2

• Optionally, only count breaks on the player's own island
• No extra setup - it works even without SSB installed

Catches players who farm mobs with an auto-clicker while AFK.

◆ Catch Auto-Clickers

• Flags inhumanly fast clicking - you set how many clicks in how long
• PvP is ignored by default, so normal fighting is not affected
• Admins get a notification, and it can be posted to Discord

Updating the plugin just got much easier.

◆ Everything Is Added For You

• New options are added to your config file automatically on update
• Language files get new messages the same way
• Your settings and translations are always kept - nothing is overwritten
• If a setting is written wrong, the plugin tells you in the console

◆ Choose Action-Based or Time-Based Control

• New afk-farm.trigger-mode in config.yml: BREAKS (default) or TIME
• BREAKS - flags after min-breaks matching breaks, just like before
• TIME - flags when matching breaks span at least min-time seconds, e.g. min-time: 10

◆ Perfect for Big Generators

• Works great when a generator has many separate mines and blocks respawn slowly
• Catches slow AFK farmers whose break count never builds up inside the window
• Match-mode POSITION, MATERIAL and ANY all work with time-based control

◆ Configurable Counter Reset

• window-seconds now also controls the counter reset time
• Break blocks, then leave - after this time the history clears and the counter resets

◆ Custom Command On Detection

• New action: COMMAND - run your own console command when farming is detected
• Set it with afk-farm.command - placeholders: {player} {world} {x} {y} {z}
• Example: action: COMMAND, command: "tempban {player} 1h AFK farming at {x},{y},{z}"

◆ Works for Fishing Too

• Time-based control also applies to fishing rod casts (min-time instead of min-casts)

◆ Action Cooldown

• New afk-farm.cooldown-seconds (default 30, 0 = off) - minimum gap between two detections
• Stops action spam (repeated COMMAND / KICK) for a persistent farmer

◆ Exempt Materials

• afk-farm.exempt-materials: blocks that never count toward farming detection
• Example: [SUGAR_CANE, PUMPKIN] - gather them freely without ANY mode flagging you

◆ Admin Alerts

• Players with the antiafk.admin permission get a message when farming is detected
• Customizable in the language files (afk-farm.admin-alert, EN/PL included)

◆ Config Validation

• On /antiafk reload the plugin warns if a farm setting can never trigger
• E.g. trigger-mode TIME with min-time higher than window-seconds, or a bad action / match-mode

◆ Safe Config Update

• Your existing config.yml settings are always preserved - never overwritten
• New options work automatically with safe defaults - no manual editing needed
• Want to see/tune the new options? Add them manually or delete config.yml to regenerate

◆ Add Hex Colors Anywhere

• New &&#RRGGBB syntax, e.g. &#FF5500 - converted automatically to the vanilla §x§R§R§G§G§B§B format
• Works in every message in the language files (lang/en_US.yml, lang/pl_PL.yml)
• Works in punishment texts in config.yml (MESSAGE, TITLE, KICK value/subtitle)

◆ Every Place You Use Colors

• Messages, titles, actionbar, bossbar, tab-list prefix
• Admin GUI and challenge GUI item names and descriptions
• /antiafk check and every chat message the plugin sends

◆ Fully Backwards Compatible

• Standard codes like &c, &e, &7 keep working exactly as before
• Your existing config and language files need no changes
• Example: &#9B59B6&lAFK#FFFFFF&7 - purple bold text with a white accent

◆ One Plugin, Two Modes

• New mode: CHALLENGE_ONLY in config.yml - no separate version needed
• AFK detection, punishments, macro/farm detection, admin GUI, stats and integrations are all disabled
• Only the verification check system stays, triggered by command

◆ Built for Anti-Cheats like GrimAC

• Send a check to any player anytime with /antiafk challenge [type]
• GUI, CHAT, MATH, SHIFT and CAPTCHA check types all available
• Fail the check and the player is kicked - perfect for anti-cheat confirmations

◆ Customizable Check GUI

• The glowstone button name and description are now fully editable
• Per-language, right in the lang files (EN/PL included)
• Every message now lives in the language files - title, button, captcha, shift, chat and math text are all yours to change

• A check left by a player who disconnects is now cleaned up in every mode
• Fixed a GUI conflict - the admin panel no longer pops open while browsing other plugins' paged menus

◆ Auto-Exempt by Permission

• Players with antiafk.exempt are now automatically exempt from AFK checks
• No more adding staff one by one in the panel - just give the permission
• Server operators get it by default, so admins are never kicked

◆ One Permission for All Staff Tools

• antiafk.admin now grants every staff permission at once
• GUI, checks, exemption, reload, export, challenges, macro bypass - all in one node

◆ All Permissions Means All

• antiafk.* now also includes the macro bypass permission

• /antiafk stats works again for regular players, just as it should
• The exempt permission really exempts now, no more surprising kicks for staff

FV