副本查询

副本.状态

• 别名：副本.读取状态
• 用法：副本.状态()
• 参数：无
• 返回值：String | null

状态 = 副本.状态()
消息.广播("&7当前副本状态: " + 状态)

副本.模板ID

• 别名：副本.副本ID
• 用法：副本.模板ID()
• 参数：无
• 返回值：String | null

模板ID = 副本.模板ID()
日志("当前模板 ID: " + 模板ID)

副本.名称

• 别名：副本.显示名
• 用法：副本.名称()
• 参数：无
• 返回值：String | null

副本名 = 副本.名称()
消息.广播("&6当前副本: " + 副本名)

副本.实例ID

• 别名：副本.读取实例ID
• 用法：副本.实例ID()
• 参数：无
• 返回值：String | null

实例ID = 副本.实例ID()
日志("实例 ID: " + 实例ID)

副本.人数

• 别名：副本.玩家数
• 用法：副本.人数()
• 参数：无
• 返回值：int

人数 = 副本.人数()
消息.广播("&b当前队伍人数: " + 人数)

副本.存活人数

• 别名：副本.存活数
• 用法：副本.存活人数()
• 参数：无
• 返回值：int

存活 = 副本.存活人数()
消息.广播("&a当前存活人数: " + 存活)

副本.已创建秒

• 别名：副本.经过秒
• 用法：副本.已创建秒()
• 参数：无
• 返回值：long

已创建 = 副本.已创建秒()
日志("副本创建秒数: " + 已创建)

副本.已运行秒

• 别名：副本.运行秒
• 用法：副本.已运行秒()
• 参数：无
• 返回值：long

已运行 = 副本.已运行秒()
消息.广播("&e本次战斗已运行: " + 已运行 + " 秒")

副本.每日限制

• 别名：无
• 用法：副本.每日限制()
• 参数：无
• 返回值：int

限制 = 副本.每日限制()
消息.广播("&e本副本每日上限: " + 限制)

补充说明：

• 读取的是当前副本模板配置的每日限制
• 没配置或配置小于等于 0 时，返回 0
• 需要副本实例上下文

副本.今日进入次数

• 别名：无
• 用法：副本.今日进入次数(["玩家名"])
• 参数：玩家名，可省略
• 返回值：int

今日已进 = 副本.今日进入次数()
队长今日已进 = 副本.今日进入次数("Alice")

消息.发送("&7你今天已经进了 " + 今日已进 + " 次")

补充说明：

• 不传玩家名时，读取当前脚本玩家自己的今日次数
• 传了玩家名时，只会在当前副本实例队伍里查这个名字
• 没有玩家上下文时返回 0
• 指定玩家不在当前副本实例里时返回 0
• 需要副本实例上下文

副本.今日剩余次数

• 别名：无
• 用法：副本.今日剩余次数(["玩家名"])
• 参数：玩家名，可省略
• 返回值：int

剩余次数 = 副本.今日剩余次数()

if 剩余次数 == 0 {
    消息.发送("&c你今天的进入次数已经用完")
}

队员剩余 = 副本.今日剩余次数("Alice")

if 队员剩余 == -1 {
    消息.发送("&a这个副本没有每日次数限制")
}

补充说明：

• 不传玩家名时，读取当前脚本玩家自己的剩余次数
• 传了玩家名时，只会在当前副本实例队伍里查这个名字
• 没有玩家上下文时返回 0
• 指定玩家不在当前副本实例里时返回 0
• 当前副本没开每日限制时返回 -1
• 需要副本实例上下文

副本.包含玩家

• 别名：副本.有玩家
• 用法：副本.包含玩家(["玩家名"])
• 参数：玩家名，可省略
• 返回值：boolean

if 副本.包含玩家("Alice") {
    消息.广播("&aAlice 仍在副本内")
}

副本.是否结束中

• 别名：副本.结束中
• 用法：副本.是否结束中()
• 参数：无
• 返回值：boolean

if 副本.是否结束中() {
    日志("副本正在结算或退场流程中")
}

副本.有延迟脚本

• 别名：副本.有挂起脚本
• 用法：副本.有延迟脚本()
• 参数：无
• 返回值：boolean

if 副本.有延迟脚本() {
    日志("当前还有挂起脚本没有执行完")
}