AdvancedVanish - 高级隐身插件

AdvancedVanish 是一款功能全面、高度可定制的隐身插件，采用 Kotlin 语言开发，能让玩家在服务器中完全隐形，如同离线一般。

💡核心特性

• 完全可配置：提供超过 70 项配置选项，满足个性化需求。
• 彻底隐身：已隐身的玩家对其他玩家和大部分插件而言，如同完全离线。
• 隐身优先级：支持设置多级隐身权限，高优先级玩家可看到低优先级玩家。
• 多权限支持：兼容 LuckPerms、PermissionsEx、bPermissions、GroupManager 等主流权限插件。
• 丰富的事件钩子：提供大量可配置的钩子，以兼容其他插件。
• 可切换的隐身行为：可配置超过 15 种在隐身状态下的行为（如阻止聊天、阻止交互等）。
• 跨服同步：支持在多服务器网络（BungeeCord/Velocity）中同步玩家的隐身状态。

🎮命令与权限

所有命令的权限节点均可在配置文件中自定义。

• /vanish - 切换自身的隐身状态。
• /vanish reload - 重新加载插件配置与钩子。
• /vanish priority - 显示你当前的隐身优先级。
• /vanish list - 显示当前所有处于隐身状态的玩家列表。
• /vanish status <player> - 检查指定玩家是否处于隐身状态。
• /vanish set <player> <on/off> - 设置其他玩家的隐身状态。
• /vanish toggle <player> - 切换其他玩家的隐身状态。

> 更多详细信息与完整功能列表，请查阅 GitBook 文档页面。

🔧开发者 API

在使用 API 前，请确保 AdvancedVanish 插件已启用，或在你的插件 plugin.yml 中添加 depend: [AdvancedVanish] 或 softdepend: [AdvancedVanish]。

Maven 依赖

首先，在 `pom.xml` 中添加仓库

<repository>
    <id>repsy</id>
    <name>quantiom</name>
    <url>https://repo.repsy.io/mvn/quantiom/minecraft</url>
</repository>

然后添加依赖（请将 <version>1.2.2</version> 替换为当前最新版本）：

<dependency>
    <groupId>me.quantiom</groupId>
    <artifactId>advancedvanish</artifactId>
    <version>1.2.2</version>
</dependency>

主要方法

// 使玩家隐身
AdvancedVanishAPI.vanishPlayer(player: Player): Unit
// 使玩家显形
AdvancedVanishAPI.unVanishPlayer(player: Player): Unit
// 检查玩家是否处于隐身状态
AdvancedVanishAPI.isPlayerVanished(player: Player): Boolean
// 检查一个玩家是否能看见另一个（隐身）玩家
AdvancedVanishAPI.canSee(player: Player, target: Player): Boolean

扩展函数

// 为 Player 类添加的扩展函数，用于检查自身隐身状态
Player.isVanished(): Boolean

事件

• PrePlayerVanishEvent - 在玩家即将隐身前触发，可取消。
• PlayerVanishEvent - 在玩家成功隐身后触发。
• PrePlayerUnVanishEvent - 在玩家即将显形前触发，可取消。
• PlayerUnVanishEvent - 在玩家成功显形后触发。

使用示例

class ExamplePlugin : JavaPlugin(), Listener {
    override fun onEnable() {
        this.server.pluginManager.registerEvents(this, this)
    }

    @EventHandler
    private fun onVanish(event: PlayerVanishEvent) {
        val vanishedPlayers = AdvancedVanishAPI.vanishedPlayers
            .map(Bukkit::getPlayer)
            .joinToString(", ", transform = Player::getName)
        this.logger.log(Level.INFO, "${event.player.name} has entered vanish.")
        this.logger.log(Level.INFO, "Current vanished players: ${vanishedPlayers}.")
    }

    @EventHandler
    private fun onUnVanish(event: PrePlayerUnVanishEvent) {
        event.isCancelled = true // 阻止玩家显形
    }
}