AntiAFKPlus v2.5 — Release Notes

AFK Credit System - Earn Time to Be Away

New Feature Overview

Revolutionary AFK Credit System: Players can now earn AFK time by being active! For every X minutes of active gameplay, players earn Y minutes of AFK allowance before being teleported to a designated AFK zone.

What’s New
1. AFK Credit Earning System

• Players earn AFK credits by being actively engaged in gameplay
• Configurable credit ratios based on permissions (default: 5 minutes active = 1 minute AFK credit)
• Real-time credit accumulation tracking with activity validation
• Maximum credit limits to prevent indefinite accumulation

2. Credit-Based AFK Protection

• When a player goes AFK, the system first consumes available credits
• Credits provide immunity from immediate kick/teleportation
• Once credits are exhausted, player is teleported to designated AFK zone
• Smooth transition from credit consumption to zone teleportation

AFK Credit System

• Earn credits while active; consume credits to delay AFK action.
• Teleport to AFK zone when credits are exhausted; /afkback returns you.

WorldGuard Integration

• Zones resolved from regions (reflection, no hard dependency).
• Teleport priority: zones.afk → zones.spawn → credit-system.afk-zone.

AFK Zone Protection

• Optional damage/PVP/mob-spawn protections near the AFK zone.

SQL History (Optional)

• Track earn/consume/admin/decay transactions when SQL is enabled.

New Placeholder

• %antiafkplus_credits_expire_days% — days until credits expire.

How It Works

1. Active players earn credits (ratio-based) up to a configurable cap.
2. When AFK is detected, 1 credit/minute is consumed to delay the action.
3. At 0 credits, the player is teleported to the AFK zone; /afkback returns them.

Configuration (added)

Messages (added)

Permissions (declared)

• antiafkplus.credit.earn — earn credits (default true)
• antiafkplus.credit.use — use credits to delay AFK action (default true)
• antiafkplus.credit.ratio.vip|premium|admin — improved ratios (default false/op)
• antiafkplus.credit.admin — full credit administration

Execution Flow

1. Active player earns credits according to ratio and limits.
2. On AFK, if credits available → cancel action and consume 1/min.
3. On activity → stop consumption (no teleport).
4. On exhaustion → teleport to AFK zone (zone‑management if present; fallback to credit-system.afk-zone).

Compatibility & Performance

• Folia‑safe (no BukkitScheduler in Folia context).
• No changes to AFKManager loop (event‑driven).
• Earning: one global job/min; consumption: per‑player task while AFK with balance.
• Respects antiafkplus.bypass.

Credit System Logic Flow

1. Credit Earning Process:

Player Active (5 minutes) → Activity Validation → Credit Calculation → Credit Award
↓
Activity Score Check → Pattern Detection → Anti-Abuse Validation → Credit Storage

2. AFK Detection with Credits:

Player Goes AFK → Check Credit Balance → Has Credits?
↓
Yes: Consume Credits → Continue Monitoring
↓
No: Save Location → Teleport to AFK Zone → Enable Return Command

3. Return Process:

Player Uses /afkback → Validate in AFK Zone → Check Original Location Safety
↓
Safe: Teleport Back → Clear AFK Status → Success Message
↓
Unsafe: Teleport to Spawn → Warning Message

✅ Benefits and Features

Player Benefits:

• Earn AFK Time: Active gameplay is rewarded with AFK allowance
• Flexible AFK: No immediate kicks, gradual credit consumption
• Safe Return: Always able to return to original location
• Transparent System: Clear feedback on credit earning and consumption

Server Owner Benefits:

• Configurable Ratios: Adjust credit earning rates by permission groups
• Abuse Prevention: Anti-pattern detection during credit earning
• Zone Management: Designated safe AFK areas
• Database Support: Optional persistent credit storage

Technical Benefits:

• Modular Design: Integrates seamlessly with existing module system
• Performance Optimized: Minimal impact on server performance
• API Complete: Full programmatic access for other plugins
• Event System: Comprehensive events for custom integrations

Integration Points

Existing System Integration:

• AFKManager: Credit verification before actions
• PatternDetector: Anti-abuse during credit earning
• ModuleManager: Full module lifecycle support
• PlaceholderAPI: Credit balance and status placeholders
• Reward System: Bonus credits through reward intervals
• Zone Management: AFK zone configuration and management

Testing Scenarios

Core Functionality Tests:

1. Credit Earning: Verify active play generates credits at correct ratios
2. Credit Consumption: Confirm AFK periods consume credits properly
3. Zone Teleportation: Test teleport when credits exhausted
4. Return Command: Validate return to original location
5. Permission Integration: Test different ratios by permission groups

Edge Case Testing:

1. Location Safety: Handle unsafe original locations
2. World Changes: Manage cross-world teleportation
3. Server Restart: Verify credit persistence (if database enabled)
4. Concurrent Usage: Test multiple players earning/using credits
5. Configuration Reload: Ensure system adapts to config changes

Compatibility

• Minecraft: 1.16 - 1.21.8+ (unchanged)
• Java: 17+ (unchanged)
• Platforms: Paper, Spigot, Bukkit, Purpur, Folia (full compatibility)
• Dependencies: None required, Vault optional for database features

Migration and Upgrade

Automatic Migration:

• Existing configurations remain unchanged
• Credit system starts disabled by default
• No breaking changes to existing functionality
• Seamless integration with current AFK detection

Manual Configuration:

• Server owners must enable credit-system.enabled: true
• Configure AFK zone location
• Adjust credit ratios for permission groups
• Customize messages and notifications

Version: 2.5
Release Date: 11/09/2025
Compatibility: Minecraft 1.16 - 1.21.8+
Java: 17+

AntiAFKPlus v2.4.2 Changelog

Complete Folia 1.21.8 Compatibility

Problem Resolved
Issue: The plugin failed to initialize on Folia 1.21.8 with UnsupportedOperationException (due to BukkitScheduler usage) and reflection errors in runAtFixedRate.

Root Cause: PlatformScheduler was using incorrect method signatures for Folia's GlobalRegionScheduler API, causing reflection failures during task scheduling.

Technical Solution Implemented

Correct Folia Method Signatures

• Before: runAtFixedRate(plugin.getClass(), Consumer.class, long.class, long.class, TimeUnit.class)
• After: runAtFixedRate(Plugin.class, Consumer.class, long.class, long.class)
• Key: no TimeUnit parameter and timing in ticks directly (no ms conversion)

️ Stronger Fallback

• Always create a ScheduledExecutorService fallback before reflection
• Graceful degradation if native Folia API fails
• Dedicated daemon thread pool for fallback operations

⚡ Additional API Fixes

• Adjusted runDelayed and run signatures for single-execution tasks
• Corrected RegionScheduler and EntityScheduler parameter types
• Consistent use of Consumer<ScheduledTask>

What’s Fixed

• ✅ Full Folia 1.21.8 compatibility: initializes and runs correctly
• ✅ No UnsupportedOperationException: removed BukkitScheduler usage in Folia context
• ✅ Timers and tasks migrated to PlatformScheduler: pattern analysis, detectors and checks operational
• ✅ Commands and AFK detection working
• ✅ Zero impact on other servers: Paper, Spigot, Bukkit, Purpur unchanged

Compatibility

• Paper/Spigot/Bukkit: ✅ unchanged, functionality preserved
• Purpur: ✅ compatible via Paper base
• Folia 1.21.8+: ✅ complete native support with correct API usage

Version: 2.4.2
Release Date: 2025-09-09
Compatibility: Minecraft 1.16 - 1.21.8
Java: 17+

Upgrade Instructions

1. Download AntiAFKPlus v2.4.2
2. Replace the old JAR in /plugins
3. Restart the server
4. No configuration changes required
5. On Folia, verify the log: “✅ Folia support initialized successfully”

• Added action state tracking to prevent repeated kick/teleport actions for the same AFK session
• Implemented safety delay to prevent immediate actions upon AFK detection
• Added automatic cleanup of action state when players become active again
• Maintained full compatibility with all existing features and API

• Players are now kicked/teleported only once after reaching their AFK timeout
• AFK timeout configurations (like default-afk-time: 600) now work correctly
• All other plugin functionality remains unchanged and fully operational

• No configuration changes required
• Fully backward compatible
• Simply replace the JAR file and restart your server

AntiAFKPlus v2.4 Changelog

🎯 Large AFK Pool Detection Enhancement

Problem Identified

Issue: Players were bypassing AFK detection by creating large AFK pools (20x10+ blocks) that circumvented existing detection systems.

Root Cause:

• Current detection focused on small confined spaces (≤5x5 blocks) and water circles (≤3 block radius)
• Large pools allowed players to move naturally via water currents without manual input
• System detected movement but couldn't distinguish between manual keystrokes and automatic water current movement

Solution Implemented

🔧 New Detection Features

1. Keystroke Timeout Detection

• Added detection for players who don't provide manual keyboard input for extended periods
• Distinguishes between manual WASD movement and automatic water current movement
• Configurable timeout threshold (default: 3 minutes)

2. Large AFK Pool Pattern Recognition

• Expanded detection to identify pools between 5x5 and 25x25 blocks
• Analyzes movement patterns to identify water current automation
• Multi-factor validation prevents false positives

3. Enhanced Movement Analysis

• Velocity analysis to detect consistent water current speeds
• Direction change analysis to identify artificial vs natural movement
• Automatic vs manual movement classification

📋 Technical Changes

Files Modified:

• MovementListener.java: Added keystroke detection and movement analysis
• PatternDetector.java: Implemented large pool detection algorithms
• config.yml: Added configuration options for new detection methods

New Configuration Options:

pattern-detection-settings:
  large-pool-threshold: 25.0  # Maximum area for large AFK pools
  keystroke-timeout-ms: 180000  # 3 minutes without manual input
  automatic-movement-velocity-threshold: 0.15  # Water current detection

🎮 Detection Logic

Large AFK Pool Detection Criteria:

1. Movement area > 5x5 but < 25x25 blocks
2. Player in water for extended periods
3. Movement patterns consistent with water currents
4. No manual keystrokes detected for 3+ minutes

Only triggers AFK when ALL criteria are met, ensuring legitimate gameplay is not affected.

✅ Benefits

• Closes bypass loophole: Large AFK pools (20x10+) are now detected effectively
• Maintains accuracy: Multi-factor validation prevents false positives
• Configurable: Server owners can adjust thresholds based on their needs
• Performance optimized: Minimal impact on server performance
• Backward compatible: All existing detection methods remain unchanged

Version: 2.4
Release Date: 2025-08-07
Compatibility: Minecraft 1.16 - 1.21.8 Java: 17+

🚀 AntiAFKPlus v2.1.0

Bug Fix Release - Essential Improvements

🐛 Bug Fixes

⚙️ Configuration Management

• Fixed /afkplus reload command - Now properly reloads all configuration files and settings
• Improved config validation - Better error handling and validation during reload
• Fixed startup messages - Removed color codes from console logs for cleaner output

🎣 AFK Detection Improvements

• Added fishing detection - Fishing machines and AFK fishing farms are now properly detected
• Enhanced activity tracking - PlayerFishEvent now triggers anti-AFK systems
• Better automation detection - Catches fish, items, and reel-in actions count as player activity

🔧 Code Quality

• Version consistency - Updated all version references to 2.1
• Cleaner logging - Console messages no longer show formatting codes
• Import optimization - Better code organization and reduced redundancy

AntiAFKPlus v2.0

Major Release - Complete Plugin Redesign

What's New

️ Modular Architecture

• Enable/disable features independently - Only use what you need
• 17 different modules including core detection, pattern analysis, rewards, and integrations
• Zero performance impact from disabled modules
• Easy customization for any server type

Multi-Platform Support

• Auto-detection of Folia, Paper, Spigot, Bukkit, and Purpur
• Automatic fallback ensures compatibility on any server
• Future-proof design for upcoming Minecraft versions

Bedrock Edition Support

• Automatic detection of Bedrock players via Floodgate/Geyser
• Touch-friendly interfaces and menu adaptations
• Optimized experience for mobile and console player

⚡ Performance Improvements

Zero-Lag Operation

• 50% less CPU usage compared to v1.x
• Adaptive check intervals based on server load
• Smart caching system reduces database queries by 80%
• Object pooling minimizes garbage collection impact

Real-Time Monitoring

• Live performance metrics and TPS impact tracking
• Automatic optimization when server load increases
• Memory usage limits prevent server strain
• Per-module performance tracking

Advanced Detection Features

Pattern Recognition

• Bot detection for circular movements and confined spaces
• Autoclick/macro detection with configurable sensitivity
• AFK pool detection for common farming setups
• False positive prevention with smart algorithms

Behavioral Analysis

• Activity scoring system tracks 18 different player actions
• Movement pattern analysis detects repetitive behavior
• Micro-movement detection catches subtle bot activities
• Learning algorithms improve detection over time

Enhanced Configuration

⚙️ Simplified Setup

• Auto-configuration for most servers
• Configuration validation prevents errors
• Automatic migration from v1.x settings
• Hot-reload for all settings without restart

️ Advanced Options

• Per-world AFK settings with inheritance
• Permission-based timeouts for different player groups
• Custom warning intervals and messages
• Zone-based AFK management with WorldGuard integration

Integrations & API

New Integrations

• WorldGuard - Region-based AFK settings
• Vault - Economy integration for rewards
• DiscordSRV - Discord notifications for AFK events
• Enhanced PlaceholderAPI - 15+ new placeholders

Professional API

• 80+ API methods for developers
• Event system with 12 different event types
• Async operations for performance-critical applications
• Thread-safe design for multi-threaded plugins

️ Player Protection Features

AFK Player Safety

• Invulnerability system prevents damage while AFK
• Movement restriction options to prevent exploitation
• Interaction blocking to prevent griefing
• Automatic position restoration when returning

Reward System

• AFK rewards for idle time (configurable)
• Anti-abuse measures prevent exploitation
• Economic integration with Vault-compatible plugins
• Daily limits and playtime requirements

Visual & UI Improvements

✨ Enhanced Effects

• Hologram support (DecentHolograms, HolographicDisplays)
• Particle effects for AFK players
• Tab list modifications show AFK status
• Customizable visual indicators

Mobile-Friendly Interface

• Touch-optimized menus for Bedrock players
• Simplified layouts for smaller screens
• Gesture-friendly controls for mobile devices

Quality of Life Improvements

Better Commands

• Improved `/afk list` with sorting and filtering
• Status command shows plugin health and performance
• Debug commands for troubleshooting
• Auto-completion for all commands

Enhanced Analytics

• Detailed statistics tracking for administrators
• Export functionality for data analysis
• Performance reports for optimization
• Usage patterns help configure optimal settings

Bug Fixes & Stability

️ Major Fixes

• Memory leak in player tracking system resolved
• Thread safety issues fixed for high-load servers
• Edge cases in AFK detection improved
• Configuration reload now works correctly in all scenarios

Security Improvements

• Input validation prevents configuration exploits
• Permission checks strengthened across all features
• API access properly secured for third-party plugins

Migration & Compatibility

Automatic Migration

• Seamless upgrade from v1.x with automatic config conversion
• Backup creation before migration for safety
• Setting preservation maintains your customizations
• Rollback option if needed

✅ Backward Compatibility

• API compatibility maintained for existing plugins
• Command structure unchanged for user familiarity
• Permission system extended but compatible

Installation Notes

Installation Steps:

1. Backup your server before upgrading
2. Replace the old JAR with the new v2.0 file
3. Restart your server (reload not supported for major versions)
4. Review new config options in `config.yml`
5. Test AFK detection with different player scenarios

Minimum Requirements:

• Java 17+ (recommended: Java 21)
• Minecraft 1.16+ (tested up to 1.21.5)
• 4GB+ RAM for optimal performance with all modules

Links & Support

• Documentation: Updated wiki with all new features
• Discord Support: https://discord.gg/xKUjn3EJzR
• Bug Reports: GitHub Issues
• ⭐ Rate & Review: Help others discover this plugin!

Download AntiAFKPlus v2.0 now and experience the most advanced AFK management system for Minecraft!

AntiAFKPlus v1.4 - Major Refinements & New Features!

This update brings a host of internal improvements, new features, and enhanced configurability to AntiAFKPlus, making it more stable, user-friendly, and powerful!

✨ New Features & Major Improvements

• Advanced Autoclicker Detection:
  • Detection parameters (click window, threshold, minimum idle time) are now fully configurable in config.yml.
  • Define specific actions upon detection: LOG (default), SET_AFK, or KICK the player.
• Command Tab Completion: Enjoy easier command usage with tab completion for /afk and /afkplus subcommands and arguments.
• Enhanced Developer API:
  • Added getTimeSinceLastActivity(Player) method to the API.
  • Improved reliability and predictability of markAsAFK(Player) and unmarkAFK(Player) API calls.

🔧 Enhancements & Optimizations

• Core System Refactoring: Significant internal code restructuring for better stability, performance, and easier future development.
• Robust Task & Listener Management: All plugin tasks and event listeners are now managed more effectively, ensuring proper startup and shutdown, preventing potential errors or memory leaks.
• Optimized Event Handling: Refined player activity listeners (movement, interaction, etc.) for more accurate AFK state updates.
• Clearer Logging: Improved console logging for AFK events and debug information.

🐛 Bug Fixes

• Addressed various internal logic issues for more consistent AFK state transitions (manual vs. automatic).
• Corrected method calls for PlaceholderAPI integration, ensuring placeholders like %antiafkplus_afktime% work reliably.
• Resolved minor bugs in command processing and message display.
• Ensured proper cleanup of player-specific data on quit/kick and for internal listeners.

⚙️ Configuration & Permissions

• Complete Message Customization: Virtually all messages sent to players are now configurable via messages.yml.
• New Configuration Options:
  • broadcast-afk-state-changes: Toggle global "Player is now AFK" / "Player is no longer AFK" messages.
  • Full externalization of autoclicker detection settings.
• Granular & Documented Permissions:
  • Introduced more specific permissions (e.g., antiafkplus.reload, antiafkplus.status.check, antiafkplus.bypass.autoclick, antiafkplus.bypass.itempickup).
  • config.yml and plugin.yml now feature improved comments and a comprehensive permission overview for easier server administration.

Before Updating:

• Please backup your existing AntiAFKPlus configuration files (config.yml, messages.yml).
• Review the updated config.yml and messages.yml generated by v1.4 and transfer your settings. New options have been added!

Thank you for using AntiAFKPlus! We hope you enjoy these improvements.

🔄 AntiAFKPlus v1.3 – Smarter, Stronger, Safer

This update brings quality-of-life improvements and intelligent detection systems to enhance AFK protection for modern Minecraft servers.

✅ New Features

• 🧠 Autoclick Detection (Experimental)
  Detects suspicious clicking behavior without movement — can optionally trigger AFK handling.

• 🎯 AFK Item Pickup Blocker
  Prevents AFK players from picking up items automatically. (Toggle in config.yml)

• 🧩 New Placeholder: %antiafkplus_afktime%
  Shows how long the player has been inactive in seconds.

• 🌍 disabled-worlds Support
  More flexible world control — disable AFK detection in specific worlds (overrides enabled-worlds).

• 🧪 Improved Debug System
  Enable debug: true in config.yml to log warnings, kicks, AFK changes, and detections to console.

🛠 Configuration Changes

• ➕ New config option: block-pickup-while-afk: true

• ➕ New config option: autoclick-detection: true

• 🧠 Messages are fully externalized in messages.yml

• 📁 Updated config.yml and messages.yml are auto-generated if missing

• 🔒 Safe handling of false positives (autoclick and AFK check now respect movement better)

🧰 Technical / API

• ✅ Public API now includes:

  • getLastMovement(Player) for %afktime% placeholder

  • AFK toggle and state read access

• 🔄 Full PlaceholderAPI support with %antiafkplus_status% and %antiafkplus_afktime%

• 📊 bStats remains fully functional with Plugin ID 25664

📢 Reminder

This plugin is free and open-source. If you're enjoying it, please consider:

• 🌟 Leaving a positive review

• 🧪 Joining the Support Discord

• 💡 Suggesting features for future versions (GUI, MySQL, Holograms...)

✅ Tested on Paper 1.16.5 to 1.21.5
💼 Built with performance and clarity in mind.

🔄 AntiAFKPlus v1.2 – Update Changelog

A smarter and more flexible AFK system is here.

✨ New Features

• ✅ Voluntary AFK Limit
  Players can only stay in manual AFK mode (/afk) for a configurable maximum time.

• ✅ messages.yml support
  All messages are now fully customizable in a separate messages.yml file.

• ✅ New Command: /afk list
  Lists all currently AFK players online. Permission: antiafkplus.list.

• ✅ New Command: /afk status
  Shows if you or another player is currently AFK or active.

• ✅ Softdependency for PlaceholderAPI
  Includes placeholder %antiafkplus_status% (returns "AFK" or "ACTIVE").

• ✅ Reload messages.yml with /afkplus reload

• ✅ World Filtering Enhanced
  You can now use disabled-worlds: in addition to enabled-worlds:
  (If both are set, disabled-worlds: takes priority)

• ✅ Debug Mode
  Enable debug: true in config to log AFK events in console for testing.

🛠 Improvements

• Improved internal checks for AFK manual mode expiration.

• Better separation of config and messages logic.

• Enhanced permission control and command handling.

🧩 Compatibility

• ✅ Supports 1.16 – 1.21.5

• ✅ Works with Paper, Purpur, Spigot

• ✅ PlaceholderAPI ready

• 📊 Metrics via bStats (Plugin ID: 25664)

💬 Need help? Join our support Discord:

https://discord.gg/xKUjn3EJzR

🔔 Don’t forget to leave a ★ on Spigot if you enjoy the plugin!

🟢 Changelog – AntiAFKPlus v1.1

🎉 AntiAFKPlus v1.1 is here with major improvements and new features!

This update focuses on customizability, stability, and player experience.

✨ New Features

- ✅ messages.yml added – fully customizable and supports colors
- ✅ /afk list command to see who is AFK (with configurable permission)
- ✅ Configurable limit for voluntary AFK (/afk) with auto-exit
- ✅ Developer API included for external plugin integration
- ✅ Configurable permission node for /afk list

⚙️ Improvements

- 🔹 Broadcasts now correctly show on AFK enter/exit
- 🔹 Kick messages are now loaded from config properly
- 🔹 Warnings before kick work at all configured intervals
- 🔹 Improved AFK detection logic for login edge cases
- 🔹 Cleaner structure, ready for future premium edition

🐛 Fixes

- 🛠️ Fixed players getting stuck in AFK kick loop after reconnect
- 🛠️ Fixed warnings not appearing due to timing errors
- 🛠️ Fixed missing broadcast messages on AFK toggle

📚 How to Update

1. Stop your server
2. Replace your old JAR with the new one
3. Delete messages.yml if it doesn't generate (only once)
4. Restart and reconfigure as needed
5. Use /afkplus reload to reload configs anytime

- ✅ Supports Minecraft 1.16 to 1.21.5
- 🧠 Lightweight, async-safe, and open source
- 📈 Includes bStats (optional and anonymous)
- 🛠️ Ready for integrations via developer API
- 🧩 PlaceholderAPI support coming soon in next update