DivineAFK

DivineAFK — AFK detection with rewards, a dedicated zone and an on-screen indicator
===================================================================================


DivineAFK marks a player as away when real activity stops and then lets you decide what
happens next: notify, move them to an AFK zone, or reward them periodically for staying online.
It is built on Folia's per-entity scheduler (one task per player, never a global loop over every
online player), so each player's check runs on that player's own thread instead of one loop
that walks the whole server.
Detection separates real activity from false positives: counting only mouse movement flags
someone mining in place as AFK, and counting any movement fails to catch a player parked in a
vehicle. DivineAFK listens for both cases separately.
FEATURES
-----------------
- Configurable detection based on real inactivity, with a cancellable event
(PlayerAFKEvent) in case another plugin needs to exempt a player.
- Periodic rewards while the player is AFK, with a maximum cap and fully configurable
commands.
- Optional AFK zone: teleports the player to a designated point when they go AFK and
returns them where they were on activity.
- The AFK zone return location is saved to disk: a player who disconnects there, or across a
restart or crash, is sent back to where they were at their next login.
- Configurable list of actions that count as activity (default: every kind, as before).
- PlaceholderAPI expansion: %divineafk_status%, AFK time, idle time and AFK count.
- On-screen indicator (bossbar or actionbar) showing the time left until the next
reward.
- Admin GUI (/divineafk gui) listing AFK players, with direct teleport to inspect them.
- Optional WorldGuard region restriction: rewards only apply inside a region with the
flag enabled.
- Public API with events so other plugins can react to AFK state.
- Genuinely Folia-native: one task per entity, never a global loop across region
threads.
REQUIREMENTS
-----------------
Paper 1.21.x or newer, Java 21+. Dependencies: None required. Optional: WorldGuard, PlaceholderAPI, DivineCore.
MAIN COMMAND
-----------------
/divineafk
LANGUAGES
-----------------
16 languages included out of the box, with per-player client language detection.
LICENSE
-----------------
This community release is available at no cost and includes the features documented here.
Advanced editions and separately licensed Divine products may add capabilities later; this
listing does not promise the scope or pricing of future editions.