副本、玩家与变量写入

公共变量与副本流程

变量.设置

• 用法：变量.设置("变量名", 值)
• 参数：变量名和值
• 返回值：写入后的值

变量.设置("暴雪开启", 1)
消息.广播("&b暴雪机制已激活")

副本.结束

• 用法：副本.结束()
• 参数：无
• 返回值：无

消息.广播("&6所有阶段完成，副本即将结束")
副本.结束()

副本.移除玩家

• 用法：副本.移除玩家(["玩家名"])
• 参数：玩家名，可省略
• 返回值：无

if 玩家.读取变量("弃权") == true {
    消息.发送("&7你已退出当前挑战")
    副本.移除玩家()
}

副本.设置变量

• 用法：副本.设置变量("变量名", 值)
• 参数：变量名和值
• 返回值：写入后的值

副本.设置变量("Boss已激活", true)

副本.读取变量

• 用法：副本.读取变量("变量名")
• 参数：变量名
• 返回值：任意类型

Boss状态 = 副本.读取变量("Boss已激活")
if Boss状态 == true {
    消息.发送("&cBoss 战已经开启")
}

副本.玩家变量

• 用法：副本.玩家变量("玩家名", "变量名")
• 参数：玩家名、变量名
• 返回值：任意类型

积分 = 副本.玩家变量("Alice", "积分")
消息.广播("&eAlice 当前积分: " + 积分)

副本.全员求和

• 用法：副本.全员求和("变量名")
• 参数：变量名
• 返回值：double

总分 = 副本.全员求和("积分")
消息.广播("&6全队累计积分: " + 总分)

副本.玩家列表

• 用法：副本.玩家列表()
• 参数：无
• 返回值：List<String>

名单 = 副本.玩家列表()
消息.广播("&7当前在线成员: " + 名单)

副本.全员平均

• 用法：副本.全员平均("变量名")
• 参数：变量名
• 返回值：double

平均积分 = 副本.全员平均("积分")
消息.广播("&b全队平均积分: " + 平均积分)

玩家会话变量

玩家.设置变量

• 用法：玩家.设置变量("变量名", 值)
• 参数：变量名和值
• 返回值：写入后的值

玩家.设置变量("贡献点", 0)
消息.发送("&7你的贡献点已重置")

玩家.增加变量

• 别名：玩家.给予变量
• 用法：玩家.增加变量("变量名", 数值)
• 参数：变量名、增加值
• 返回值：double

新积分 = 玩家.增加变量("积分", 25)
消息.发送("&a获得积分，当前总分: " + 新积分)

玩家.扣除变量

• 用法：玩家.扣除变量("变量名", 数值)
• 参数：变量名、扣除值
• 返回值：double

if 玩家.读取变量("钥匙数") >= 1 {
    剩余 = 玩家.扣除变量("钥匙数", 1)
    消息.发送("&e已消耗钥匙，剩余: " + 剩余)
}

玩家.读取变量

• 用法：玩家.读取变量("变量名")
• 参数：变量名
• 返回值：任意类型

当前层数 = 玩家.读取变量("个人层数")
消息.发送("&b你的个人层数: " + 当前层数)

局内货币与复活

货币.给予

• 用法：货币.给予("货币名", 数量)
• 参数：货币名、数量
• 返回值：double

余额 = 货币.给予("水晶", 30)
消息.发送("&d获得 30 水晶，当前余额: " + 余额)

货币.扣除

• 用法：货币.扣除("货币名", 数量)
• 参数：货币名、数量
• 返回值：double

if 玩家.读取变量("已开门") != true {
    剩余水晶 = 货币.扣除("水晶", 10)
    玩家.设置变量("已开门", true)
    消息.发送("&e开门成功，剩余水晶: " + 剩余水晶)
}

货币.设置

• 用法：货币.设置("货币名", 数量)
• 参数：货币名、数量
• 返回值：double

货币.设置("水晶", 0)
消息.发送("&7你的本局水晶已清零")

复活.执行

• 用法：复活.执行([是否扣次数], [位置])
• 参数：是否扣次数；复活位置可写 出生点、原地、脚本
• 返回值：无

消息.发送("&a队友技能触发，你将原地复活")
复活.执行(false, "原地")