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.
