AntiAFKPlus 2.9.5

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