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.

Source Code

AFK Area is open source and licensed under the MIT License.

View the source code on GitHub

Support

For support, questions, or discussion, join the Tebrox Development Discord.

More Plugins

Looking for more plugins by Tebrox?

View all public plugins