AfkVeil

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.