AFKArea

# AFK Area AFK Area is a configurable **AFK management plugin for Paper servers**. It combines automatic inactivity detection with dedicated AFK areas, rewards, visibility control, persistent player statistics, and anti-abuse features. Players can be marked AFK automatically after a configurable period of inactivity or manually using `/afk`. After a longer period of inactivity, they can optionally be moved to a configured AFK area automatically. Players may also enter an AFK area voluntarily at any time. --- ## AFK Areas AFK areas can use either native cuboid regions or existing WorldGuard regions. Each area can have its own: - Display name - Teleport location - Priority - Reward configuration WorldGuard-backed areas can optionally include child and descendant regions, making it possible to build larger or multi-level AFK areas from an existing region hierarchy. --- ## Rewards AFK Area includes a flexible command-based reward system. Rewards support: - Weighted random selection - Multiple commands per reward - Interval or milestone schedules - Multiple reward rolls - Optional duplicate prevention - Per-reward permissions - Custom reward messages Because rewards are command-based, they can easily be used with economy, crate, item, experience, and other server systems. --- ## Visibility Players inside an AFK area can automatically be hidden from normal players in both the world and player list. Staff members with the appropriate permission can continue to see them. AFK Area also integrates with TAB and PlaceholderAPI for servers that use external player-list formatting. --- ## Anti-Abuse Reward distribution can be limited for players sharing the same IP address. Persistent household groups allow legitimate players sharing a connection to be treated as one reward identity without disabling the protection entirely. --- ## Player Information AFK Area keeps persistent statistics for completed AFK area sessions, including: - Session count - Total AFK area time - Longest session - Last session duration - Last visited area Optional bossbar and actionbar displays can show the current session and time remaining until the next reward. --- ## Features - Automatic and manual AFK handling - Configurable AFK and teleport timers - Native cuboid AFK areas - Optional WorldGuard integration - WorldGuard child and descendant region support - Automatic AFK area teleporting - Cross-world teleport destinations - Configurable area priorities - Player visibility control with staff bypass - Weighted command rewards - Interval and milestone reward schedules - IP-based reward limiting - Persistent household grouping - Persistent player statistics - Bossbar and actionbar displays - PlaceholderAPI integration - TAB integration - JSON, H2 and MySQL/MariaDB persistence - MiniMessage and legacy `&` color support - bStats metrics --- ## Requirements - **Paper 1.21.4 or newer** - **Java 21 or newer** - **VertexCore 1.1.0 or newer** ### Optional integrations - **WorldGuard + WorldEdit** — use existing WorldGuard regions as AFK areas - **PlaceholderAPI** — expose AFK Area placeholders - **TAB** — integrate AFK status with external player-list formatting AFK Area is designed for Paper servers and does not currently support Spigot. --- ## Installation 1. Install **VertexCore 1.1.0 or newer**. 2. Place the AFK Area JAR in your server's `plugins` directory. 3. Install any optional integrations you want to use. 4. Start the server. 5. Configure AFK Area and create your AFK areas. --- ## Documentation Complete setup and configuration documentation is available in the [AFK Area Wiki](https://github.com/Tebrox-Development/AFKArea/wiki). ## Source Code AFK Area is open source and licensed under the **MIT License**. [View the source code on GitHub](https://github.com/Tebrox-Development/AFKArea) ## Support For support, questions, or discussion, join the [Tebrox Development Discord](https://discord.gg/QRcVgVkAZr). ## More Plugins Looking for more plugins by Tebrox? [View all public plugins](https://tebrox-development.github.io/Plugins/)