玩家与世界

本页收录 PlayerBuiltins 和 WorldBuiltins，主要覆盖玩家状态、位置、经济、药水效果与世界环境读取。

获取生命值

• 用法：获取生命值()
• 参数：无
• 返回值：Number

赋值 hp = 获取生命值()
发送消息("&c当前生命值: " + hp)

获取最大生命值

• 用法：获取最大生命值()
• 参数：无
• 返回值：Number

赋值 maxHp = 获取最大生命值()
发送消息("&f最大生命值: " + maxHp)

获取饥饿值

• 用法：获取饥饿值()
• 参数：无
• 返回值：Number

赋值 food = 获取饥饿值()
发送消息("&6当前饥饿值: " + food)

获取经验等级

• 用法：获取经验等级()
• 参数：无
• 返回值：Number

赋值 level = 获取经验等级()
发送消息("&a当前等级: " + level)

获取游戏模式

• 用法：获取游戏模式()
• 参数：无
• 返回值：String

赋值 mode = 获取游戏模式()
发送消息("&7模式: " + mode)

获取玩家名

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

赋值 name = 获取玩家名()
发送消息("&f玩家: " + name)

获取显示名

• 用法：获取显示名()
• 参数：无
• 返回值：String

赋值 display = 获取显示名()
发送消息("&f显示名: " + display)

获取坐标X

• 用法：获取坐标X()
• 参数：无
• 返回值：Number

赋值 x = 获取坐标X()
发送消息("&7X: " + x)

获取坐标Y

• 用法：获取坐标Y()
• 参数：无
• 返回值：Number

赋值 y = 获取坐标Y()
发送消息("&7Y: " + y)

获取坐标Z

• 用法：获取坐标Z()
• 参数：无
• 返回值：Number

赋值 z = 获取坐标Z()
发送消息("&7Z: " + z)

获取朝向

• 用法：获取朝向()
• 参数：无
• 返回值：Number

赋值 yaw = 获取朝向()
发送消息("&fYaw: " + yaw)

获取俯仰角

• 用法：获取俯仰角()
• 参数：无
• 返回值：Number

赋值 pitch = 获取俯仰角()
发送消息("&fPitch: " + pitch)

获取世界名

• 用法：获取世界名()
• 参数：无
• 返回值：String

赋值 world = 获取世界名()
发送消息("&b所在世界: " + world)

获取在线时长

• 用法：获取在线时长()
• 参数：无
• 返回值：Number
• 补充说明：源码会优先读取 Bukkit 统计项 PLAY_ONE_MINUTE，旧版本回退到 PLAY_ONE_TICK，最后统一按 20 tick = 1 秒 换算；两种统计都不可用时返回 0。

赋值 online = 获取在线时长()
发送消息("&7在线秒数: " + online)

获取金币

• 用法：获取金币()
• 参数：无
• 返回值：Number

赋值 money = 获取金币()
发送消息("&6金币余额: " + money)

是否在线

• 用法：是否在线()
• 参数：无
• 返回值：Boolean

判断 (是否在线()) {
  发送消息("&a玩家当前在线")
}

是否在潜行

• 用法：是否在潜行()
• 参数：无
• 返回值：Boolean

判断 (是否在潜行()) {
  发送消息("&7你正在潜行")
}

是否在飞行

• 用法：是否在飞行()
• 参数：无
• 返回值：Boolean

判断 (是否在飞行()) {
  发送消息("&b飞行状态已开启")
}

是否在疾跑

• 用法：是否在疾跑()
• 参数：无
• 返回值：Boolean

判断 (是否在疾跑()) {
  发送消息("&e你正在疾跑")
}

是否在地面

• 用法：是否在地面()
• 参数：无
• 返回值：Boolean

判断 (是否在地面()) {
  发送消息("&a当前在地面上")
}

是否在水中

• 用法：是否在水中()
• 参数：无
• 返回值：Boolean

判断 (是否在水中()) {
  发送消息("&b你正处于水体中")
}

取玩家变量

• 用法：取玩家变量(变量名)
• 参数：变量名
• 返回值：Object

赋值 combo = 取玩家变量("连击层数")
发送消息("&f当前连击: " + combo)

设置玩家变量

• 用法：设置玩家变量(变量名, 值)
• 参数：变量名、值
• 返回值：Boolean

设置玩家变量("签到次数", 7)
发送消息("&a已写入签到次数")

获取飞行速度

• 用法：获取飞行速度()
• 参数：无
• 返回值：Number

赋值 speed = 获取飞行速度()
发送消息("&b飞行速度: " + speed)

获取行走速度

• 用法：获取行走速度()
• 参数：无
• 返回值：Number

赋值 speed = 获取行走速度()
发送消息("&a行走速度: " + speed)

给予药水效果

• 用法：给予药水效果(效果, 等级, 秒数)
• 参数：效果名、等级、秒数
• 返回值：Boolean

给予药水效果("SPEED", 2, 10)
发送消息("&a已给予速度效果")

移除药水效果

• 用法：移除药水效果(效果)
• 参数：效果名
• 返回值：Boolean

移除药水效果("SPEED")
发送消息("&7已移除速度效果")

是否有药水效果

• 用法：是否有药水效果(效果)
• 参数：效果名
• 返回值：Boolean

判断 (是否有药水效果("NIGHT_VISION")) {
  发送消息("&b夜视效果仍在持续")
}

清除所有药水效果

• 用法：清除所有药水效果()
• 参数：无
• 返回值：Boolean

清除所有药水效果()
发送消息("&c已清空全部药水效果")

获取世界时间

• 用法：获取世界时间()
• 参数：无
• 返回值：Number

赋值 time = 获取世界时间()
发送消息("&7世界时间: " + time)

世界是否白天

• 用法：世界是否白天()
• 参数：无
• 返回值：Boolean

判断 (世界是否白天()) {
  发送消息("&e当前是白天")
}

世界是否黑夜

• 用法：世界是否黑夜()
• 参数：无
• 返回值：Boolean

判断 (世界是否黑夜()) {
  发送消息("&9当前是夜晚")
}

世界是否下雨

• 用法：世界是否下雨()
• 参数：无
• 返回值：Boolean

判断 (世界是否下雨()) {
  发送消息("&b外面正在下雨")
}

世界是否打雷

• 用法：世界是否打雷()
• 参数：无
• 返回值：Boolean

判断 (世界是否打雷()) {
  发送消息("&c雷暴天气已触发")
}

世界是否晴天

• 用法：世界是否晴天()
• 参数：无
• 返回值：Boolean

判断 (世界是否晴天()) {
  发送消息("&a当前是晴天")
}

获取世界难度

• 用法：获取世界难度()
• 参数：无
• 返回值：String

赋值 diff = 获取世界难度()
发送消息("&f世界难度: " + diff)

获取世界生物数量

• 用法：获取世界生物数量()
• 参数：无
• 返回值：Number

赋值 count = 获取世界生物数量()
发送消息("&7实体数量: " + count)

获取世界玩家数量

• 用法：获取世界玩家数量()
• 参数：无
• 返回值：Number

赋值 count = 获取世界玩家数量()
发送消息("&f同世界玩家数: " + count)

获取服务器玩家数量

• 用法：获取服务器玩家数量()
• 参数：无
• 返回值：Number

赋值 count = 获取服务器玩家数量()
发送消息("&f在线总人数: " + count)

在区域内

• 用法：在区域内(区域ID)
• 参数：区域 ID
• 返回值：Boolean

判断 (在区域内("spawn")) {
  发送消息("&a你位于出生区")
}

在指定高度范围

• 用法：在指定高度范围(最小高度, 最大高度)
• 参数：最小高度、最大高度
• 返回值：Boolean

判断 (在指定高度范围(60, 80)) {
  发送消息("&e当前高度符合要求")
}

距离坐标点

• 用法：距离坐标点(X, Y, Z)
• 参数：目标坐标
• 返回值：Number

赋值 dist = 距离坐标点(100, 64, 200)
发送消息("&7距离目标点: " + dist)

在坐标范围内

• 用法：在坐标范围内(X1, Y1, Z1, X2, Y2, Z2)
• 参数：两个角点坐标
• 返回值：Boolean

判断 (在坐标范围内(0, 60, 0, 100, 90, 100)) {
  发送消息("&a你已进入活动盒区")
}