V AFKZone

🏗️ V-AfkZone

Timed AFK Rewards for Paper Servers

Simple vertical transportation for Paper 1.21.1+ servers

✨ Features

• 🎯 WorldGuard Integration — Create AFK zones using existing WorldGuard regions
• 🌍 AFK Everywhere — Permission-based rewards outside designated zones
• ⏱️ Flexible Timers — Configure reward intervals per zone or profile
• 📊 Visual Feedback — Boss bars, action bars, titles, and chat messages
• 🖱️ Admin GUI — In-game management with /afkzone
• 🔌 PlaceholderAPI — Full expansion with 13+ placeholders
• 🔔 Custom Events — Developer API with cancellable events
• 🔄 Auto Migration — Seamless upgrades from legacy configs
• ⚡ Zero Lag — Optimized scheduler with configurable intervals
• 🔒 Protected Zones — Prevent double-rewarding with zone priority system

🚀 Installation

1. Download the latest V-AfkZone-1.0.0.jar
2. Place the jar in your server's plugins/ folder
3. Ensure WorldGuard and WorldEdit are installed
4. Start the server to generate default configs
5. Configure zones in plugins/V-AfkZone/area/
6. Reload with /afkzone reload or restart

🎮 Quick Start

Creating Your First AFK Zone

# 1. Create a WorldGuard region first
/region define spawn_afk

# 2. Create the zone config
/afkzone create zone spawn_afk

# 3. Edit plugins/V-AfkZone/area/spawn_afk.yml

Enabling AFK Everywhere

# 1. Create the profile
/afkzone create everywhere afk

# 2. Grant permission to players
/lp user <player> permission set vafkzone.everywhere.use true

# 3. Reload the plugin
/afkzone reload

⌨️ Commands

🔐 Permissions

💡 Tip: Custom everywhere profiles can use any permission node (e.g., vafkzone.everywhere.vip)

⚙️ Configuration

Zone Config (area/spawn_afk.yml)

### Zone identification
zoneName: spawn_afk
worldGuardRegion: spawn_afk
worldName: world

### Reward settings
requiredSeconds: 60
enabled: true

### Visual feedback
show-bossbar: true
show-actionbar: true
show-reward-received-message: true

### Sound effects
sound: false
sound-type: level_up

### Protection - blocks AFK Everywhere in this zone
disable-afk-everywhere: false

### Commands run as console when reward fires
rewardCommands:
  - give %player% diamond 1
  - broadcast %player% earned a reward from AFK zone spawn_afk!

Everywhere Profile (everywhere/afk.yml)

enabled: true
permission: vafkzone.everywhere.use
priority: 0

### Movement detection
walking: true
idle-threshold-seconds: 60

### Reward settings
requiredSeconds: 60

### Visual feedback
show-bossbar: true
show-actionbar: true
show-reward-received-message: true

### Sound effects
sound: false
sound-type: level_up

### Commands
rewardCommands:
  - give %player% diamond 1
  - broadcast %player% earned a reward from AFK Everywhere!

Global Config (config.yml)

settings:
  check-interval-seconds: 1  # Scheduler tick rate
  show-bossbar: true         # Master boss bar switch
  notify-admin-on-reward: false  # Log to online admins
  debug: false              # Extra console logging

messages:
  ### MiniMessage format supported
  prefix: "<gradient:#3b82f6:#8b5cf6>[V-AfkZone]</gradient> "

🔌 PlaceholderAPI

When PlaceholderAPI is installed, the vafkzone expansion is auto-registered: