Sueta

AFKRegions | Boost your player retention 1.8 to 1.21

1.0.4

Rewards players for staying AFK in regions, with full PlaceholderAPI support and stats

·Plugin

afkregions.png
AFKRegions is a Spigot plugin that detects when a player is inside a specific region and, after a configurable amount of time, automatically executes rewards (commands). Perfect for AFK reward systems, mini-games, events, or waiting areas.

Features

  • Define regions with commands.
  • Automatic detection when a player enters or leaves a region.
  • Execute commands as rewards after a set time in the region.
  • Multiple rewards per region with configurable times and chances.
  • PlaceholderAPI support to customize commands and messages.
  • Progress display with elapsed time, max time, and percentage.
  • Configurable messages for entering, leaving, and rewards.

Commands
Command Description
/afkregions wand Selects a region (left click = pos1, right click = pos2)
/afkregions create <name> <duration_s> Creates a region from your current selection
/afkregions reward list <region> Lists all rewards in a region
/afkregions reward add <region> <chance%> <time_s> <command...> Adds a reward to a region
/afkregions reward remove <region> <index> Removes a reward from a region
/afkregions remove <region> Deletes a region
/afkregions reload Reloads the plugin configuration

Permissions
Permission Description
afkregions.admin Grants access to all admin commands

PlaceholderAPI Placeholders
These placeholders can be used via PlaceholderAPI.
General region placeholders
%afkregions_is_afk% Returns true if the player is currently AFK inside a defined region, otherwise false.
%afkregions_region_name% The name of the AFK region the player is currently in.
%afkregions_time% The elapsed time in seconds that the player has been in the current region.
%afkregions_duration% The total required time in seconds to complete the region's cycle.
%afkregions_progress% The player's progress in the region as a percentage (0–100).
%afkregions_progress_bar% A visual progress bar made of text characters.
%afkregions_time_left% The remaining time in seconds before the region cycle completes.
Player statistics placeholders
%afkregions_total_afk_<seconds/minutes/hours>% Returns the statistic of the total AFK time in the specified time
%afkregions_total_afk_time% Returns the statisticof the total AFK time but formated (hh mm ss)

Easy setup video
YouTube

afk regions, afk rewards, afkrewards, afk player, afk players, rewards afk, playtime, player rewards

Similar projects

Plugin →