# \ud83c\udfd7\ufe0f V-AfkZone
\n**Timed AFK Rewards for Paper Servers**<\/p>\n
> Simple vertical transportation for Paper 1.21.1+ servers<\/p>\n
\n<\/p>\n<\/div>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfaf **WorldGuard Integration** \u2014 Create AFK zones using existing WorldGuard regions
\n– \ud83c\udf0d **AFK Everywhere** \u2014 Permission-based rewards outside designated zones
\n– \u23f1\ufe0f **Flexible Timers** \u2014 Configure reward intervals per zone or profile
\n– \ud83d\udcca **Visual Feedback** \u2014 Boss bars, action bars, titles, and chat messages
\n– \ud83d\uddb1\ufe0f **Admin GUI** \u2014 In-game management with `\/afkzone`
\n– \ud83d\udd0c **PlaceholderAPI** \u2014 Full expansion with 13+ placeholders
\n– \ud83d\udd14 **Custom Events** \u2014 Developer API with cancellable events
\n– \ud83d\udd04 **Auto Migration** \u2014 Seamless upgrades from legacy configs
\n– \u26a1 **Zero Lag** \u2014 Optimized scheduler with configurable intervals
\n– \ud83d\udd12 **Protected Zones** \u2014 Prevent double-rewarding with zone priority system<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. **Download** the latest `V-AfkZone-1.0.0.jar`
\n2. **Place** the jar in your server’s `plugins\/` folder
\n3. **Ensure** WorldGuard and WorldEdit are installed
\n4. **Start** the server to generate default configs
\n5. **Configure** zones in `plugins\/V-AfkZone\/area\/`
\n6. **Reload** with `\/afkzone reload` or restart<\/p>\n
—<\/p>\n
## \ud83c\udfae Quick Start<\/p>\n
### Creating Your First AFK Zone<\/p>\n
“`bash
\n# 1. Create a WorldGuard region first
\n\/region define spawn_afk<\/p>\n
# 2. Create the zone config
\n\/afkzone create zone spawn_afk<\/p>\n
# 3. Edit plugins\/V-AfkZone\/area\/spawn_afk.yml
\n“`<\/p>\n
### Enabling AFK Everywhere<\/p>\n
“`bash
\n# 1. Create the profile
\n\/afkzone create everywhere afk<\/p>\n
# 2. Grant permission to players # 3. Reload the plugin —<\/p>\n ## \u2328\ufe0f Commands<\/p>\n | Command | Permission | Description | —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Default | Description | > \ud83d\udca1 **Tip:** Custom everywhere profiles can use any permission node (e.g., `vafkzone.everywhere.vip`)<\/p>\n —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n ### Zone Config (`area\/spawn_afk.yml`)<\/p>\n “`yaml ### Reward settings ### Visual feedback ### Sound effects ### Protection – blocks AFK Everywhere in this zone ### Commands run as console when reward fires ### Everywhere Profile (`everywhere\/afk.yml`)<\/p>\n “`yaml ### Movement detection ### Reward settings ### Visual feedback ### Sound effects ### Commands ### Global Config (`config.yml`)<\/p>\n “`yaml messages: —<\/p>\n ## \ud83d\udd0c PlaceholderAPI<\/p>\n When PlaceholderAPI is installed, the `vafkzone` expansion is auto-registered:<\/p>\n | Placeholder | Description | —<\/p>\n","protected":false},"excerpt":{"rendered":" V-AfkZone – AFK Zone tracker with WorldGuard integration and configurable rewards.<\/p>\n","protected":false},"featured_media":163596,"template":"","meta":{"_minecraft_slug":"vafkzone","_minecraft_project_id":"2P7Howh6","_minecraft_author":"ReakZ","_minecraft_license":"MIT","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vafkzone.zip","_minecraft_size_bytes":78485,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:08:43.864936Z","_minecraft_date_created":"2026-04-12T02:50:53.948588Z","_minecraft_date_modified":"2026-04-10T09:11:01.395030Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vafkzone","_minecraft_icon_attachment_id":163596,"_minecraft_imported_at":"2026-06-09T16:43:12+00:00","_minecraft_import_hash":"8dfc8f252bef4b2cabba2506cea94e3a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,126,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-163595","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n\/lp user
\n\/afkzone reload
\n“`<\/p>\n
\n|———|————|————-|
\n| `\/afkzone` | `vafkzone.admin` | Opens admin GUI |
\n| `\/afkzone menu` | `vafkzone.admin` | Opens main GUI |
\n| `\/afkzone reload` | `vafkzone.admin` | Reloads all configs |
\n| `\/afkzone info` | `vafkzone.info` | Shows your active sessions |
\n| `\/afkzone sessions` | `vafkzone.admin` | Shows all active sessions |
\n| `\/afkzone sessions
\n| `\/afkzone create zone
\n| `\/afkzone create everywhere
\n| `\/afkzone edit
\n| `\/afkzone edit zone
\n| `\/afkzone edit everywhere
\n| `\/afkzone delete
\n| `\/afkzone delete zone
\n| `\/afkzone delete everywhere
\n| `\/afkzone setup
\n| `\/afkzone everywhere
\n|————|———|————-|
\n| `vafkzone.admin` | `op` | Full admin access |
\n| `vafkzone.info` | `true` | View own AFK info |
\n| `vafkzone.use` | `true` | Use AFK zones |
\n| `vafkzone.everywhere.use` | `false` | Use default everywhere profile |<\/p>\n
\n### Zone identification
\nzoneName: spawn_afk
\nworldGuardRegion: spawn_afk
\nworldName: world<\/p>\n
\nrequiredSeconds: 60
\nenabled: true<\/p>\n
\nshow-bossbar: true
\nshow-actionbar: true
\nshow-reward-received-message: true<\/p>\n
\nsound: false
\nsound-type: level_up<\/p>\n
\ndisable-afk-everywhere: false<\/p>\n
\nrewardCommands:
\n – give %player% diamond 1
\n – broadcast %player% earned a reward from AFK zone spawn_afk!
\n“`<\/p>\n
\nenabled: true
\npermission: vafkzone.everywhere.use
\npriority: 0<\/p>\n
\nwalking: true
\nidle-threshold-seconds: 60<\/p>\n
\nrequiredSeconds: 60<\/p>\n
\nshow-bossbar: true
\nshow-actionbar: true
\nshow-reward-received-message: true<\/p>\n
\nsound: false
\nsound-type: level_up<\/p>\n
\nrewardCommands:
\n – give %player% diamond 1
\n – broadcast %player% earned a reward from AFK Everywhere!
\n“`<\/p>\n
\nsettings:
\n check-interval-seconds: 1 # Scheduler tick rate
\n show-bossbar: true # Master boss bar switch
\n notify-admin-on-reward: false # Log to online admins
\n debug: false # Extra console logging<\/p>\n
\n ### MiniMessage format supported
\n prefix: “
\n“`<\/p>\n
\n|————-|————-|
\n| `%vafkzone_in_zone%` | true\/false if in any zone |
\n| `%vafkzone_zone_name%` | Current zone name |
\n| `%vafkzone_zone_names%` | All active zone names |
\n| `%vafkzone_next_reward%` | Seconds until next reward |
\n| `%vafkzone_rewards_total%` | Total rewards earned |
\n| `%vafkzone_time_in_zone%` | Seconds in current zone |
\n| `%vafkzone_required_seconds%` | Required seconds for zone |
\n| `%vafkzone_in_everywhere%` | true\/false if in everywhere mode |
\n| `%vafkzone_everywhere_name%` | Active everywhere profile |
\n| `%vafkzone_everywhere_next_reward%` | Seconds until everywhere reward |
\n| `%vafkzone_everywhere_rewards_total%` | Total everywhere rewards |
\n| `%vafkzone_any_active%` | true\/false any AFK active |
\n| `%vafkzone_active_count%` | Number of active sessions |<\/p>\n