✨ VanishCore
一款原生为 Folia 打造的轻量级 CMI 风格隐身插件。
v1.0.3 · Folia 26.1.x · Java 21
VanishCore 将工作人员从普通玩家视野中隐藏——他们不再出现在视图中,也不显示在标签页列表中,对于常规命令而言完全表现为离线状态。该插件基于 Folia 的区域化调度器模型编写,因此能在 Folia 上正常运行,无需依赖传统的 Bukkit.getScheduler()。
功能 · 命令 · 权限 · 占位符 · 配置 · 安装 · 要求
功能
? 隐形
- 隐身玩家完全从其他玩家的视野中移除。
- 从标签页列表中移除,使姓名不再出现在玩家列表 (需要 ProtocolLib)。
- 可选的夜视效果(可切换)。
- 可选的隐身效果,以阻止客户端渲染仍可见的物品和盔甲。
? 隐身优先级等级
- 每位隐身玩家都有一个隐身等级,这样高级别的工作人员可以看见低级别隐身的同事,同时对其他人保持隐藏。
- 通过
vanishcore.level.<n> 权限授予可见性——查看者可以看到其自身等级或更低等级的隐身玩家。
vanishcore.see 作为主权限,可揭示所有隐身玩家。
? 无声箱子
- 打开箱子、 barrel、潜影盒和末影箱时,不会向他人展示开盖动画或声音。
- 需要 ProtocolLib;如果未安装则自动禁用。
? 完全离线外观
- 对于
/msg、/pay、/tpa 和 /trade 等可配置命令,隐身玩家被报告为离线——发送者仅收到 "Player not found"(玩家未找到)。
- 被拦截的命令列表完全可配置。
- 拥有
vanishcore.see(或足够等级)的工作人员仍可正常联系隐身玩家。
?️ 隐身期间的保护
- 生物不会攻击隐身玩家。
- 隐身玩家不会受到玩家攻击或投射物的伤害。
- 压力板、绊线绳和海龟蛋不会被触发。
- 可选禁用物品拾取。
? 真正保持隐藏
- 死亡消息在隐身玩家死亡时不广播。
- 进度/成就公告被抑制。
- 幽匿感测体、幽匿尖啸体和监守者永远无法检测到隐身玩家(振动被取消)。
- 幻翼永远不会在隐身玩家身上生成——“距休息的时间”会被重置,防止幻翼俯冲并暴露他们。
? 设置 GUI
/vanishedit 打开一个简洁的可点击设置菜单。
- 所有功能均可在运行时切换——无需编辑配置文件或重启服务器。
- 更改立即保存,菜单就地刷新。
? 跨平台感知
- Floodgate / Geyser 支持:可选跳过原始数据包特性(标签页过滤、无声箱子),因为 Geyser 会转换他们的数据包。实体级别的隐藏仍然适用于所有人。
⚙️ 其他选项
- 隐身状态在重新连接后持久保留。
- 允许的工作人员加入时自动隐身。
- 可选的隐身期间 Boss 栏指示器。
- 可选的隐藏加入/退出消息及工作人员通知。
- PlaceholderAPI 扩展,用于在任何地方显示隐身状态。
- 完全可配置的带有
& 颜色代码的消息。
命令
| 命令 |
别名 |
描述 |
权限 |
/vanish [player] |
/v, /uvanish |
切换自己或其他玩家的隐身状态 |
vanishcore.use |
/vanishlist |
/vlist, /vanishedlist |
列出当前隐身的玩家 |
vanishcore.list |
/vanishmsg <player> <message> |
/vmsg |
向隐身的工作人员发送消息 |
vanishcore.msgvanish |
/vanishedit [setting] [on|off] |
/vedit |
打开设置 GUI 或切换某项功能 |
vanishcore.edit |
权限
| 权限 |
描述 |
默认值 |
vanishcore.use |
对自己使用 /vanish |
op |
vanishcore.others |
隐身或解除其他玩家的隐身 |
op |
vanishcore.see |
看见所有隐身玩家(最高等级) |
false |
vanishcore.level.1 |
看见等级 1 或更低的隐身玩家 |
false |
vanishcore.level.2 |
看见等级 2 或更低的隐身玩家 |
false |
vanishcore.level.3 |
看见等级 3 或更低的隐身玩家 |
false |
vanishcore.list |
查看隐身玩家列表 |
op |
vanishcore.autovanish |
加入时自动隐身 |
false |
vanishcore.msgvanish |
向隐身玩家发送消息 |
op |
vanishcore.edit |
通过 /vanishedit 切换功能 |
op |
注意: vanishcore.see 默认为 false,因此除非明确授予权限,否则管理员看不到隐身玩家。仅将 vanishcore.see(或 vanishcore.level.<n>)授予那些应该能够看到隐身玩家的职位。
占位符
需要 PlaceholderAPI。扩展标识符:vanishcore。
| 占位符 |
返回值 |
%vanishcore_vanished% |
玩家的 true / false 状态 |
%vanishcore_status% |
Vanished / Visible(可配置文本) |
%vanishcore_level% |
玩家的隐身等级(若未隐身则为 0) |
%vanishcore_count% |
当前隐身玩家的数量 |
%vanishcore_count_visible% |
查看者有权看到的隐身玩家数量 |
%vanishcore_list% |
查看者可以看到的用逗号分隔的名称列表 |
配置
所有行为均在 plugins/VanishCore/config.yml 中配置,或通过 /vanishedit 实时切换。
vanish:
apply-invisibility: false # 在持续客户端上隐藏手持物品/盔甲
apply-night-vision: true # 让隐身状态下的管理员能在黑暗中视物
prevent-mob-targeting: true
prevent-item-pickup: false
hide-join-quit-messages: true
notify-staff-on-toggle: true
persist-across-rejoin: true
prevent-pvp-damage: true
prevent-physical-triggers: true # 压力板 / 绊线 / 海龟蛋
show-bossbar: true
hide-death-messages: true
hide-advancement-messages: true
hide-from-sculk: true # 幽匿传感器 / 尖啸体 / 监守者
prevent-phantoms: true
fake-offline: true # 对 /msg、/pay、/tpa 等命令显示为离线
intercept-commands: [ msg, tell, pay, tpa, trade, ... ]
protocollib:
silent-chest-open: true
geyser:
skip-packet-features-for-bedrock: false
placeholders:
status-vanished: "Vanished"
status-visible: "Visible"
所有消息均可在 messages: 部分使用 & 颜色代码进行配置。
安装
- 将
VanishCore-1.0.3.jar 放入服务器的 plugins/ 文件夹中。
- (可选) 安装 ProtocolLib 以启用标签页列表隐藏和无声打开箱子功能。
- (可选) 安装 PlaceholderAPI 以使用上述占位符。
- (可选) 如果你运行的是 Geyser/基岩版环境,请安装 Floodgate。
- 重启服务器。
- 调整
plugins/VanishCore/config.yml 中的设置,或在游戏内使用 /vanishedit 命令。
即使没有 ProtocolLib,插件仍可正常运行——仅禁用标签页列表隐藏和无声打开箱子功能。
? Folia 支持
Folia 会在各自的线程上独立处理世界各个区域的刻(tick),因此调用传统 Bukkit.getScheduler() 的插件可能会在 Folia 上失效。VanishCore 完全避免了这一问题:
- 仅使用
RegionScheduler、EntityScheduler 和 AsyncScheduler。
- 实体和玩家操作在所属区域线程上运行,并带有已废弃任务的回调机制。
- 共享状态使用线程安全的并发集合。
- 绝不使用
Bukkit.getScheduler()。
要求
|
|
| 服务器 |
Folia 1.21.x(已在 26.1.2 版本测试) |
| Java |
21 或更高版本 |
| 可选 |
ProtocolLib —— 标签页列表隐藏 & 无声打开箱子 |
| 可选 |
PlaceholderAPI —— %vanishcore_*% 占位符 |
| 可选 |
Floodgate —— Geyser/基岩版数据包处理 |
专为 Folia 打造 · VanishCore v1.0.3
✨ VanishCore
A lightweight, CMI-style vanish plugin built natively for Folia.
v1.0.3 · Folia 26.1.x · Java 21
VanishCore hides staff members from regular players — they are removed from view, from the
tab list, and appear completely offline to common commands. It is written around Folia's
regionized scheduler model, so it runs correctly on Folia without relying on the legacy
Bukkit.getScheduler().
Features · Commands · Permissions · Placeholders · Configuration · Installation · Requirements
Features
? Invisibility
- Vanished players are removed from other players' view entirely.
- Tab-list removal so the name no longer appears in the player list (requires ProtocolLib).
- Optional night vision while vanished (toggleable).
- Optional invisibility effect to hide held items and armor from clients still rendering them.
? Vanish priority levels
- Each vanished player has a vanish level, so higher-ranked staff can see lower-ranked vanished staff while staying hidden from everyone else.
- Visibility is granted through
vanishcore.level.<n> permissions — a viewer sees vanished players of their level or lower.
vanishcore.see acts as the master permission and reveals all vanished players.
? Silent chest
- Open chests, barrels, shulker boxes, and ender chests without the lid animation or sound being shown to others.
- Requires ProtocolLib; disabled automatically if it is not installed.
? Appear fully offline
- Vanished players are reported as offline to configurable commands such as
/msg, /pay, /tpa, and /trade — the sender simply gets "Player not found".
- The full list of intercepted commands is configurable.
- Staff with
vanishcore.see (or sufficient level) can still reach vanished players normally.
?️ Protection while vanished
- Mobs do not target vanished players.
- Vanished players take no damage from player attacks or projectiles.
- Pressure plates, tripwires, and turtle eggs are not triggered.
- Item pickup can optionally be disabled.
? Stay truly hidden
- Death messages are not broadcast when a vanished player dies.
- Advancement / achievement announcements are suppressed.
- Sculk sensors, sculk shriekers, and the Warden never detect a vanished player (vibrations are cancelled).
- Phantoms never spawn on vanished players — "time since rest" is reset so a phantom can't dive in and reveal them.
? Settings GUI
/vanishedit opens a clean, clickable settings menu.
- Every feature can be toggled at runtime — no config editing or restart required.
- Changes are saved immediately and the menu refreshes in place.
? Cross-platform aware
- Floodgate / Geyser support: optionally skip raw-packet features (tab-list filtering, silent chest) for Bedrock players, since Geyser translates their packets. Entity-level hiding still applies to everyone.
⚙️ Additional options
- Vanish state persists across reconnects.
- Auto-vanish on join for permitted staff.
- Optional boss bar indicator while vanished.
- Optional hidden join/quit messages and staff notifications.
- PlaceholderAPI expansion for displaying vanish status anywhere.
- Fully configurable messages with
& color codes.
Commands
| Command |
Aliases |
Description |
Permission |
/vanish [player] |
/v, /uvanish |
Toggle vanish for yourself or another player |
vanishcore.use |
/vanishlist |
/vlist, /vanishedlist |
List currently vanished players |
vanishcore.list |
/vanishmsg <player> <message> |
/vmsg |
Message a vanished staff member |
vanishcore.msgvanish |
/vanishedit [setting] [on|off] |
/vedit |
Open the settings GUI or toggle a feature |
vanishcore.edit |
Permissions
| Permission |
Description |
Default |
vanishcore.use |
Use /vanish on yourself |
op |
vanishcore.others |
Vanish or unvanish other players |
op |
vanishcore.see |
See all vanished players (highest level) |
false |
vanishcore.level.1 |
See vanished players of level 1 or lower |
false |
vanishcore.level.2 |
See vanished players of level 2 or lower |
false |
vanishcore.level.3 |
See vanished players of level 3 or lower |
false |
vanishcore.list |
View the list of vanished players |
op |
vanishcore.autovanish |
Automatically vanish on join |
false |
vanishcore.msgvanish |
Message vanished players |
op |
vanishcore.edit |
Toggle features via /vanishedit |
op |
Note: vanishcore.see defaults to false, so operators do not see vanished players unless the permission is explicitly granted. Grant vanishcore.see (or a vanishcore.level.<n>) only to ranks that should be able to see vanished players.
Placeholders
Requires PlaceholderAPI. Expansion identifier: vanishcore.
| Placeholder |
Returns |
%vanishcore_vanished% |
true / false for the player |
%vanishcore_status% |
Vanished / Visible (configurable text) |
%vanishcore_level% |
The player's vanish level (0 if not vanished) |
%vanishcore_count% |
Number of currently vanished players |
%vanishcore_count_visible% |
Vanished players the viewer is allowed to see |
%vanishcore_list% |
Comma-separated names the viewer may see |
Configuration
All behavior is configured in plugins/VanishCore/config.yml, or toggled live via /vanishedit.
vanish:
apply-invisibility: false # hide held items/armor on lingering clients
apply-night-vision: true # let vanished staff see in the dark
prevent-mob-targeting: true
prevent-item-pickup: false
hide-join-quit-messages: true
notify-staff-on-toggle: true
persist-across-rejoin: true
prevent-pvp-damage: true
prevent-physical-triggers: true # pressure plates / tripwires / turtle eggs
show-bossbar: true
hide-death-messages: true
hide-advancement-messages: true
hide-from-sculk: true # sculk sensors / shriekers / Warden
prevent-phantoms: true
fake-offline: true # appear offline to /msg, /pay, /tpa, ...
intercept-commands: [ msg, tell, pay, tpa, trade, ... ]
protocollib:
silent-chest-open: true
geyser:
skip-packet-features-for-bedrock: false
placeholders:
status-vanished: "Vanished"
status-visible: "Visible"
Every message is configurable with & color codes under the messages: section.
Installation
- Place
VanishCore-1.0.3.jar in your server's plugins/ folder.
- (Optional) Install ProtocolLib to enable tab-list hiding and silent chest.
- (Optional) Install PlaceholderAPI for the placeholders above.
- (Optional) Install Floodgate if you run a Geyser/Bedrock setup.
- Restart the server.
- Adjust settings in
plugins/VanishCore/config.yml, or use /vanishedit in-game.
Without ProtocolLib the plugin still runs — only tab-list hiding and silent chest are disabled.
? Folia support
Folia ticks each region of the world on its own thread, so plugins that call the legacy
Bukkit.getScheduler() can fail on Folia. VanishCore avoids this entirely:
- Uses
RegionScheduler, EntityScheduler, and AsyncScheduler only.
- Entity and player actions run on the owning region thread, with retired-task callbacks.
- Shared state uses thread-safe concurrent collections.
Bukkit.getScheduler() is never used.
Requirements
|
|
| Server |
Folia 1.21.x (tested on 26.1.2) |
| Java |
21 or newer |
| Optional |
ProtocolLib — tab-list hiding & silent chest |
| Optional |
PlaceholderAPI — %vanishcore_*% placeholders |
| Optional |
Floodgate — Geyser/Bedrock packet handling |
Made for Folia · VanishCore v1.0.3
评论 0
登录后参与评分
还没有评论,来抢沙发吧