AdvancedAFK

AdvancedAFK

The ultimate AFK plugin for Paper servers — featuring god mode protection, auto-kick, multi-language support, and fully configurable exit triggers.

Note

- If some people have security concerns about this project because it involves AI, and they understand security, they can contribute to this project. I generally insist that the code should comply with S.O.L.I.D. to make it readable and to make it easy to add features. I think the code is readable. - If some people have security concerns about this project because it involves AI, and they understand security, they can contribute to this project. I generally insist that the code should comply with S.O.L.I.D. to make it readable and to make it easy to add features. I think the code is readable.

✨ Features

🛡️ God Mode Protection

AFK players are completely protected: - Position lock from any source (mobs, players, environment) - Position lock from attacks or explosions - Position lock — cannot be pushed by entities or water

⏰ Auto-AFK & Auto-Kick

- Smart kick: Automatically set players AFK after inactivity - Smart kick: Kick players who are AFK too long (disabled by default) - Smart kick: Only kick when server reaches minimum player threshold

⚙️ Configurable Exit Triggers

Choose exactly what actions should remove AFK status: - Mouse movement (looking around) - Sneaking (pressing shift) - Interacting (clicking) - Chatting - Running commands - Opening inventory

*Each trigger can be individually enabled or disabled!*

🌍 Multi-Language Support

- Built-in 12 machine translations and 12 machine translations languages - 12 machine translations available on GitHub - Easily add your own translations - All messages are fully customizable

📊 PlaceholderAPI Integration

Display AFK information anywhere using PlaceholderAPI: - `%advancedafk_status%` — "AFK" or empty - `%advancedafk_time%` — Formatted duration - `%advancedafk_reason%` — AFK reason - `%advancedafk_is_afk%` — "true" or "false" - And more!

🏷️ Tab List Support

Shows [AFK] prefix in the player list without breaking other plugins' formatting.

📈 bStats Analytics

Anonymous usage statistics to help improve the plugin.

---

📋 Commands

| Command | Description | |---------|-------------| | `/afk [reason]` | Toggle AFK mode with optional reason | | `/afkreload` | Reload configuration and language files |

🔑 Permissions

| Permission | Description | Default | |------------|-------------|---------| | `advancedafk.use` | Use /afk command | Everyone | | `advancedafk.reload` | Use /afkreload | OP | | `advancedafk.bypass.cooldown` | Bypass cooldown | OP | | `advancedafk.bypass.kick` | Bypass auto-kick | OP |

---

⚡ Requirements

- PlaceholderAPI (or compatible fork) - PlaceholderAPI - PlaceholderAPI (optional, for placeholders)

---

Note

The coding of this Plugin was done entirely by AI.

If some people have security concerns about this project because it involves AI, and they understand security, they can contribute to this project on github. I generally insist that the code should comply with S.O.L.I.D. to make it readable and to make it easy to add features. I think the code is readable.

📥 Quick Start

1. Download and place in your `plugins/` folder 2. Restart the server 3. Use `/afk` to toggle AFK mode!

Customize everything in `plugins/AdvancedAFK/config.yml`