AfkVeil — Region-Based Player Isolation for Bukkit & Paper

AfkVeil is a lightweight and efficient Bukkit/Paper plugin designed to fully isolate players within a designated WorldGuard region. Players inside the configured area become completely invisible to those outside — and vice versa — ensuring a clean, distraction-free environment.


Whether you're managing a large survival server, a minigame hub, or an SMP, AfkVeil keeps AFK players truly out of sight and out of mind. No tab-list clutter, no unnecessary entity rendering, and no accidental interactions with invisible players.



How It Works

When a player enters the configured AFK region, AfkVeil performs the following actions:

• Hides the player from all others using Bukkit’s native hidePlayer API
• Applies a silent invisibility effect (no particles, no status icon) for compatibility with other plugins
• Optionally removes the player from the tab list to prevent visibility in menus and autocomplete
• Displays a configurable particle effect to indicate the transition
• Sends an action bar message to inform the player of their hidden state
• Ensures mutual invisibility — AFK players cannot see non-AFK players

A lightweight, repeating synchronization task (default: every 20 ticks / 1 second) ensures that newly joined players instantly respect the correct visibility state without excessive WorldGuard queries.


To maintain performance, the plugin uses block-level movement deduplication, avoiding redundant checks caused by minor positional updates.


When a player leaves the region or disconnects, all effects are immediately reverted and full visibility is restored.



Key Features

✔ Supports any WorldGuard region (no size or world limitations)
✔ True mutual invisibility between AFK and non-AFK players
✔ Optional tab-list hiding for complete player concealment
✔ Configurable particle effects (WITCH, PORTAL, CLOUD, ENCHANT, etc.)
✔ Fully customizable action bar notifications (with color codes)
✔ Optimized movement handling to prevent unnecessary processing
✔ Automatic synchronization for newly joined players
✔ Hot-reload support via /afkveil reload
✔ Permission-based command system (afkveil.admin, default: OP)



Configuration

All features are easily configurable via config.yml:

• afk-region — WorldGuard region name
• refresh-interval — Sync interval in ticks (default: 20)
• hide-from-tab.enabled — Toggle tab-list visibility
• particles.enabled / particles.type — Particle settings
• actionbar.enabled — Enable/disable notifications
• messages — Fully customizable with & color codes

Dependencies

• WorldGuard (required)
  WorldEdit (required)
  ProtocolLib (required)

Compatibility

• Paper / Spigot 1.21+
• API Version: 1.21

Free

AfkVeil is completely free


No license restrictions.
No premium tiers.
No paywalls.