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.
