-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Tebrox edited this page Sep 20, 2026
·
4 revisions
AFK Area combines automatic player inactivity handling with dedicated AFK areas for Paper servers.
Players can be marked AFK automatically or manually, moved into configured AFK areas after longer periods of inactivity and rewarded while staying inside them.
AFK areas can use native cuboid regions or optional WorldGuard regions.
- Automatic and manual AFK handling
- Automatic teleporting after configurable idle time
- Native cuboid AFK areas
- Optional WorldGuard-backed AFK areas
- Cross-world teleport destinations
- Area priorities for overlapping regions
- Player visibility control with staff bypass
- Weighted command rewards
- Interval and milestone reward schedules
- Per-reward permissions and messages
- IP-based reward limiting
- Persistent household grouping
- Persistent AFK session statistics
- Bossbar and actionbar displays
- PlaceholderAPI integration
- TAB integration
- JSON, H2 and MySQL/MariaDB persistence
- MiniMessage and legacy
&color support
| Requirement | Details |
|---|---|
| Paper | 1.21.4 or newer |
| Java | Java 21 or newer; use the version required by your Paper build |
| VertexCore | 1.1.0 or newer |
| Integration | Purpose |
|---|---|
| WorldGuard + WorldEdit | Use WorldGuard regions as AFK areas |
| PlaceholderAPI | Expose AFK Area placeholders |
| TAB | Use AFK Area data in external player-list formatting |
AFK Area is designed for Paper servers and does not currently support Spigot.
New installations should start here:
After creating your first AFK area, you can configure rewards, displays and optional integrations as needed.
- Installation — Install AFK Area and its dependencies
- Configuration — Main configuration options
- AFK Areas — Create and manage AFK areas
- AFK Handling — Automatic AFK detection, manual AFK and teleport behavior
- WorldGuard Integration — Use WorldGuard regions instead of native cuboids
- Commands & Permissions — Complete command and permission reference
- Rewards — Reward pools, schedules, weights, commands and messages
- Anti‐Abuse & Households — IP reward limits and household grouping
- Bossbar & Actionbar — AFK area display configuration
- Statistics — Persistent player AFK statistics
- PlaceholderAPI & TAB — Available placeholders and TAB integration
- Database & Storage — JSON, H2 and MySQL/MariaDB persistence
- Troubleshooting — Common problems and diagnostic information
A typical AFK Area setup looks like this:
- Install AFK Area and VertexCore.
- Configure the automatic AFK timers.
- Create a native cuboid or WorldGuard AFK area.
- Set the area's teleport destination.
- Configure the default automatic teleport area.
- Add rewards if desired.
- Configure visibility, displays and optional integrations.
More detailed instructions are available on the individual Wiki pages.
AFK Area Wiki
Setup
Administration
Integrations & Storage
Help