🚀 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