AntiAFKPlus 1.0

✨ AntiAFKPlus

Smart and configurable AFK management for your Minecraft server!

—

What is AntiAFKPlus?

AntiAFKPlus is a lightweight yet powerful plugin that automatically kicks inactive players after a configurable period.

Warn players before kicking, set per-permission timeouts, let players go AFK manually, and keep your server clean and fair.

Perfect for Survival, Factions, Minigames, Hub, or Network servers.

—

️ Main Features

• ⏳ Configurable AFK kick time (global and per permission)
• ️ Bypass permission to exclude staff or VIPs
• ⚡ Multi-warning system before kick (custom intervals like 60s, 30s, 10s)
• Broadcasts when players enter or leave AFK
• ✋ Manual AFK toggle with the /afk command
• ️ Per-world control: enable AFK checks only in selected worlds
• Fully customizable messages with {player} and {seconds} placeholders
• Reload config instantly using /afkplus reload
• Built-in bStats support
• ✅ Supports Minecraft versions 1.16 to 1.21+

—
Installation

1. Download the latest .jar file
   
   
2. Place it into your /plugins/ folder
   
   
3. Restart your server or use /reload
   
   
4. Edit /plugins/AntiAFKPlus/config.yml as desired

—

Commands

/afkplus reload

• Reloads configuration without restarting
  
  
• Permission: antiafkplus.admin

/afk

• Manually toggle AFK status
  
  
• Permission: antiafkplus.afk

—

️ Permissions

• antiafkplus.bypass – Exempts player from all AFK checks
• antiafkplus.admin – Allows use of /afkplus reload
• antiafkplus.afk – Allows manual AFK toggle using /afk
• antiafkplus.time.600 – 10 minutes AFK timeout
• antiafkplus.time.900 – 15 minutes AFK timeout
• antiafkplus.time.1800 – 30 minutes AFK timeout

—
️ Configuration Example

Default settings:

default-afk-time: 300
afk-check-interval-seconds: 5
afk-warnings:
60
30
10
messages: afk-enter: "&7{player} is now AFK."
afk-exit: "&a{player} is no longer AFK."
kick-warning: "&eYou will be kicked in {seconds} seconds for being AFK!"
kicked: "&cYou have been kicked for being AFK."

Use & color codes as usual. Placeholders like {player} and {seconds} are replaced automatically.

—

Developer API

AntiAFKPlus provides a simple and public API for developers.
You can check if a player is AFK or force AFK/return.

Example usage:

AntiAFKPlus plugin = (AntiAFKPlus) Bukkit.getPluginManager().getPlugin("AntiAFKPlus"); AntiAFKPlusAPI api = plugin.getAPI();

if (api.isAFK(player)) { player.sendMessage("You are AFK!"); }

See AntiAFKPlusAPI.md for full documentation.

—

Metrics

This plugin uses bStats.org to collect anonymous usage statistics.
You can disable it in the /plugins/bStats/config.yml file if desired.

—

Why Choose AntiAFKPlus?

1. Lightweight and optimized
2. ️ Highly configurable for any server
3. Multi-version support (1.16–1.21+)
4. Clean code and well-structured
5. Professional notifications and UX
6. Designed for performance and simplicity

—
Coming Soon in the Premium Version

⭐ MySQL support
⭐ Teleport to lobby or spawn instead of kicking
⭐ Anti-autoclicker and AFK-farming protection
⭐ DecentHolograms / GHolo integration
⭐ Kick/AFK logging system
⭐ Extended PlaceholderAPI support

Support development by upgrading to the Premium version soon!

—

Support & Contact

GitHub: https://github.com/koyere/AntiAFKPlus
Discord: Coming soon

—

✨ Keep your server clean, fair, and professional with AntiAFKPlus! ✨