AfkVeil — 基于区域的玩家隔离(适用于 Bukkit & Paper)
AfkVeil 是一款轻量且高效的 Bukkit/Paper 插件,旨在将玩家完全隔离在指定的 WorldGuard 区域内。处于配置区域内的玩家对区域外的玩家完全不可见——反之亦然——从而确保一个干净、无干扰的环境。
无论您是在管理大型生存服务器、小游戏大厅还是 SMP 服,AfkVeil 都能让挂机(AFK)玩家真正“眼不见心不烦”。不会出现标签页列表杂乱、不必要的实体渲染,以及与隐形玩家发生意外交互的情况。
工作原理
当玩家进入配置的 AFK 区域时,AfkVeil 会执行以下操作:
使用 Bukkit 原生的 hidePlayer API 将该玩家从所有其他玩家视野中隐藏
应用无声的隐身效果(无粒子、无状态图标),以兼容其他插件
可选地从标签页列表中移除该玩家,防止其在菜单和自动补全功能中可见
显示可配置的粒子效果以指示状态切换
发送动作栏消息以告知玩家其已被隐藏的状态
确保相互不可见——AFK 玩家无法看到非 AFK 玩家
一个轻量级的重复同步任务(默认每 20 刻 / 1 秒)确保新加入的玩家能立即遵守正确的可见性状态,而无需进行过多的 WorldGuard 查询。
为了保持性能,该插件采用区块级移动去重机制,避免因微小的位置更新而导致冗余检查。
当玩家离开区域或断开连接时,所有效果会立即撤销,并恢复完全可见性。
主要特性
✔ 支持任意 WorldGuard 区域(无大小或世界限制)
✔ AFK 玩家与非 AFK 玩家之间的真实相互不可见
✔ 可选的标签页隐藏以实现完全隐蔽
✔ 可配置的粒子效果(WITCH、PORTAL、CLOUD、ENCHANT 等)
✔ 完全自定义的动作栏通知(支持颜色代码)
✔ 优化的移动处理以防止不必要的计算
✔ 新加入玩家的自动同步
✔ 通过 /afkveil reload 支持热重载
✔ 基于权限的命令系统(afkveil.admin,默认为 OP)
配置
所有功能均可通过 config.yml 轻松配置:
afk-region — WorldGuard 区域名称
refresh-interval — 同步间隔(单位:刻,默认:20)
hide-from-tab.enabled — 切换标签页可见性
particles.enabled / particles.type — 粒子设置
actionbar.enabled — 启用/禁用通知
messages — 完全自定义,支持 & 颜色代码
依赖项
WorldGuard(必需)
WorldEdit(必需)
ProtocolLib(必需)
兼容性
Paper / Spigot 1.21+
API 版本:1.21
免费
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧