SuperVanish >> Be invisible - SuperVanish - 高级隐身插件

SuperVanish 是一款高级隐身插件，能让其他玩家认为你不在服务器上。非常适合用于抓破坏者或测试新管理员！

💡主要特性

• 隐身玩家完全不可见。
• 在玩家列表（Tab）中隐藏隐身玩家。
• 调整服务器列表中的在线玩家数量（需要 ProtocolLib）。
• 对于有权查看隐身玩家的玩家，在 Tab 列表中，隐身玩家的头部可见且名字显示为斜体灰色（可关闭；仅限 1.18 及以下版本）。
• 分层权限系统，可精确配置谁能看到谁。
• 为隐身玩家显示动作栏（需要 ProtocolLib）。
• 几乎所有插件消息都可在 messages.yml 中自定义。
• 隐身状态在玩家加入/退出、服务器重载/重启后依然保持。
• 隐身玩家无法拾取物品。
• 禁用隐身玩家的“常规”加入/离开消息。
• 在隐身/现身时广播虚假的加入/离开消息。
• 为隐身玩家禁用伤害。
• 隐藏隐身玩家手中的物品和盔甲。
• 可在游戏内重载配置。
• 隐身玩家可无声打开箱子（需要 ProtocolLib）。
• 隐身玩家不会触发压力板。
• 隐身玩家即使在生存模式下也能飞行。
• 隐身玩家不会阻挡方块放置。
• 隐身玩家不会阻挡箭矢（但会被传送到上方两格处）。
• 无法看到隐身玩家的玩家无法通过 Tab 键补全其名字。
• 支持 PlaceholderAPI，为其他插件提供占位符。
• 支持 DiscordMC（需安装 SuperVanishDiscordMC）。
• 可安装 BBV by Haskins 来获取 Boss 栏隐身指示器。
• 可使用 %supervanish_vanishprefix% 和 %supervanish_vanishsuffix% 占位符，仅在玩家隐身时显示特殊前缀/后缀。

推荐依赖

• 为获得最佳无声开箱体验，请安装 OpenInv。
• 部分功能需要 ProtocolLib。

🎮命令与权限

命令格式：[...] 表示可选，<...> 表示必填。

基础命令

• /sv help - 显示包含命令列表的帮助页面。
• /sv [on|off] - 隐藏/显示自己。所需权限：sv.use[.levelX]。
• /sv [on|off] <player> - 隐藏/显示其他玩家。所需权限：sv.others。
• /sv reload - 重载配置文件。所需权限：sv.reload。
• /sv list - 显示隐身玩家列表。所需权限：sv.list。
• /sv login - 广播登录消息。所需权限：sv.login。
• /sv logout - 广播登出消息。所需权限：sv.logout。
• /sv recreatefiles [confirm|force] - 重新创建过时的配置文件。所需权限：sv.recreatefiles。
• /sv tipu - 切换单个玩家的物品拾取状态。所需权限：sv.toggleitems。
• /sv stacktrace - 记录信息以便报告问题。

其他重要权限

• sv.see[.levelX] - 拥有此权限的玩家可以看到隐身玩家（需在配置中启用）。
• sv.keepfly - 没有此权限的玩家在现身且非创造模式时，将失去飞行能力。
• sv.notoggle - 拥有此权限的玩家的隐身状态不能被其他玩家更改。
• sv.silentchest - 允许你无声地打开箱子。

分层权限说明

• 更高或相等的 sv.see 等级会覆盖更低或相等的 sv.use 等级；更高的 sv.use 等级会覆盖更低的 sv.see 等级。
• 格式：sv.use.level1、sv.use.level12 等；sv.see.level1、sv.see.level43 等。
• 示例：如果玩家1有 sv.use.level3，玩家2有 sv.see.level3，那么玩家2可以看到隐身的玩家1。但如果玩家1有 sv.use.level4，则玩家2无法看到他，除非玩家2有 sv.see.level4 或更高等级。
• 此功能可用于实现例如：只有服主能看到隐身的管理员，但管理员能看到隐身的管理员，管理员之间可以互相看到。
• 需在配置中开启 LayeredSeeAndUsePermissions 才能使此功能生效。
• 注意：分层权限更改后，玩家需要重新加入服务器才能生效！降职玩家时请牢记这一点。
• 不带等级的 sv.use 和 sv.see 仍然有效，且等级均为 1。
• 拥有 sv. 和/或 supervanish. 的玩家默认拥有 sv.use.level1 和 sv.see.level1。
• OP 玩家或拥有 * 权限的玩家拥有 sv.see.level100 和 sv.use.level100，因此可以看到任何玩家，且不能被任何没有 sv.see.level100 的玩家看到。
• 最高等级：100；更高的等级无效。

🔧配置

配置文件分为 config.yml 和 messages.yml，两者都有详细的注释说明。

主要配置选项 (`config.yml`)

• 隐身特性：可设置夜视效果、禁用伤害/饥饿、阻止生物锁定、无声开箱、禁用压力板、默认拾取物品选项、修改 Tab 列表和 Tab 补全数据包等。
• 隐身状态特性：可设置自动加入隐身、切换世界/退出服务器时自动现身、权限变化时自动现身等。
• 指示特性：可启用 sv.see 权限、分层权限、在 Tab 列表中将隐身玩家标记为观察者（仅限 1.18 及以下）等。
• 消息选项：可配置虚假加入/退出消息广播、管理员公告、隐藏真实消息、显示动作栏提醒等。
• 限制选项：可阻止隐身玩家破坏/放置方块、攻击实体。
• 外部隐身：可调整服务器列表中的在线玩家数量和列表。
• 钩子选项：支持与 Essentials、Dynmap、TrailGUI、PlaceholderAPI、MVdWPlaceholderAPI、Citizens 等插件集成。
• 兼容性选项：高级用户可调整事件优先级。
• 杂项：包含更新检查器等。

消息文件 (`messages.yml`)

• 所有消息均可高度自定义，支持颜色代码、HEX 颜色代码及多种占位符（如 %p% 玩家名、%other% 目标名等）。
• 可配置无权限、无效使用、隐身/现身消息、错误提示、列表前缀、动作栏消息等各种提示文本。
• 注意：编辑时请勿使用制表符，建议使用在线 YAML 解析器检查语法。
• 德文翻译版本可在此处找到。

✨API

通用隐身检查（无需依赖）

private boolean isVanished(Player player) {
    for (MetadataValue meta : player.getMetadata("vanished")) {
        if (meta.asBoolean()) return true;
    }
    return false;
}

此代码兼容 SuperVanish、PremiumVanish、EssentialsX、VanishNoPacket 等多种隐身插件。

SuperVanish/PremiumVanish 专用 API

两者共享完全相同的 API，可同时支持。

使用步骤

• 在 plugin.yml 中添加软依赖：

    softdepend: [SuperVanish, PremiumVanish]

• 使用前检查插件是否启用：

    if (Bukkit.getPluginManager().isPluginEnabled("SuperVanish") || Bukkit.getPluginManager().isPluginEnabled("PremiumVanish")) {
        // 使用 API
    }

• 将 SuperVanish.jar 添加到项目的构建路径。
• 使用 VanishAPI 类的静态方法，例如：

    import de.myzelyam.api.vanish.VanishAPI;
    import de.myzelyam.api.vanish.PlayerHideEvent;

    // 获取所有在线隐身玩家的 UUID 列表
    List<UUID> invisiblePlayers = VanishAPI.getInvisiblePlayers();
    // 隐藏玩家
    VanishAPI.hidePlayer(player);
    // 检查玩家是否隐身
    boolean isVanished = VanishAPI.isInvisible(player);
    // 检查玩家A是否能看见玩家B
    boolean canSee = VanishAPI.canSee(playerA, playerB);

事件

• PlayerHideEvent：玩家隐身时触发。
• PlayerShowEvent：玩家现身时触发。
• 重要：若要改变事件结果，请勿使用 MONITOR 优先级；若只想获取最终结果，请使用 MONITOR 优先级。

Maven 仓库

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.github.LeonMangler</groupId>
        <artifactId>SuperVanish</artifactId>
        <version>6.2.18-3</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

❓支持与问题报告

如何报告 Bug

• 请确保你使用的是 ProtocolLib 的最新开发版本。
• 如果问题依旧，请通过 SpigotMC 私信联系开发者，并提供以下信息：

- 详细描述：在什么情况下发生了什么，以及你期望发生什么。

- 控制台是否有错误堆栈跟踪？如果有，请使用 pastebin.com 分享链接。

- 如果没有错误，请说明你使用的插件列表、SV 版本及 Bukkit/Spigot 版本。

- 如果移除除 ProtocolLib（若使用）和 SV 外的所有插件后问题是否解决？如果是，请逐个添加插件以找出冲突插件，并提供其名称和版本。

注意事项

• 如需帮助或发现 Bug，请私信开发者！
• 如有一般性问题，请在插件页面评论区留言。
• 请勿在评论中请求帮助或报告 Bug！评论是最后的选择，遇到问题请先联系开发者。
• SuperVanish 基于开源许可证发布。