玩家、调试与变量函数

有权限

• 用法：有权限("权限节点")
• 参数：权限节点
• 返回值：boolean

if 有权限("dm.admin") {
    消息.发送("&a你有管理权限")
}

是否管理员

• 用法：是否管理员()
• 参数：无
• 返回值：boolean

if 是否管理员() {
    消息.发送("&e当前账号是 OP")
}

余额

• 用法：余额("变量名")
• 参数：当前玩家会话里的数值变量名
• 返回值：double

铜币余额 = 余额("铜币")
if 铜币余额 >= 50 {
    消息.发送("&a你已经攒够 50 铜币")
}

在线人数

• 用法：在线人数()
• 参数：无
• 返回值：int

当前在线 = 在线人数()
消息.广播("&7服务器在线人数: " + 当前在线)

玩家名

• 用法：玩家名()
• 参数：无
• 返回值：String 或 null

消息.发送("&e当前执行玩家: " + 玩家名())
日志("当前玩家: " + 玩家名())

这里拿到的是当前执行这段脚本的玩家。

在 玩家脚本 里，它就是当前这一轮收到消息、收到效果的那个人。

玩家UUID

• 用法：玩家UUID()
• 参数：无
• 返回值：String 或 null

当前UUID = 玩家UUID()
日志("当前 UUID: " + 当前UUID)

事件玩家名

• 用法：事件玩家名()
• 参数：无
• 返回值：String 或 null

事件绑定:
  玩家加入:
    玩家脚本: |
      消息.发送("&e" + 事件玩家名() + " &7加入了副本")

这个函数只在 玩家加入、玩家离开、玩家死亡 这三个事件里有值。

如果当前脚本没有事件玩家上下文，会返回 null。

事件玩家UUID

• 用法：事件玩家UUID()
• 参数：无
• 返回值：String 或 null

事件绑定:
  玩家死亡:
    脚本: |
      日志("本次倒下的玩家 UUID: " + 事件玩家UUID())

这个函数和 事件玩家名() 一样，只在 玩家加入、玩家离开、玩家死亡 这三个事件里有值。

玩家世界

• 用法：玩家世界()
• 参数：无
• 返回值：String 或 null

if 玩家世界() == "world_nether" {
    消息.发送("&c你当前位于下界")
}

玩家X

• 用法：玩家X()
• 参数：无
• 返回值：double

当前位置X = 玩家X()
日志("当前 X 坐标: " + 当前位置X)

玩家Y

• 用法：玩家Y()
• 参数：无
• 返回值：double

当前位置Y = 玩家Y()
if 当前位置Y <= 20 {
    消息.发送("&e你已经进入地下区域")
}

玩家Z

• 用法：玩家Z()
• 参数：无
• 返回值：double

当前位置Z = 玩家Z()
副本.设置变量("最近一次Z", 当前位置Z)

日志

• 用法：日志("内容")
• 参数：日志内容
• 返回值：原文本

日志("Boss 房倒计时已经开始")
消息.广播("&7后台日志已记录当前阶段")

调试

• 用法：调试("内容")
• 参数：调试内容
• 返回值：原文本

调试("当前阶段 = " + 阶段.当前())
调试("当前玩家数 = " + 副本.人数())

获取变量

• 用法：获取变量("变量名")
• 参数：变量名
• 返回值：当前上下文里的值

当前状态 = 获取变量("Boss已开启")
消息.广播("&eBoss 状态: " + 当前状态)

设置变量

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

设置变量("Boss已开启", true)
if 获取变量("Boss已开启") {
    消息.广播("&cBoss 开关已设为开启")
}

有变量

• 用法：有变量("变量名")
• 参数：变量名
• 返回值：boolean

if 有变量("Boss已开启") {
    日志("Boss 状态变量已经存在")
}