LogoArcartX Doc
服务端Aria实体对象

实体信息

实体对象:获取实体的坐标、朝向、生命值与状态

  • 以下函数的目标对象为生物实体(LivingEntity)。玩家也是生物实体,因此这些函数对玩家目标同样有效。

getName()

  • 获取实体名称
  • 参数:无
  • 返回值:字符串类型
  • 调用示例
实体对象.getName()

getUniqueId()

  • 获取实体 UUID 的字符串形式
  • 参数:无
  • 返回值:字符串类型
  • 调用示例
实体对象.getUniqueId()

getEntityType()

  • 获取实体类型名称,例如 PLAYER 或 ZOMBIE
  • 参数:无
  • 返回值:字符串类型
  • 调用示例
实体对象.getEntityType()

getWorldName()

  • 获取实体所在世界的名称
  • 参数:无
  • 返回值:字符串类型
  • 调用示例
实体对象.getWorldName()

getVelocityX()

  • 获取实体当前速度向量的 X 分量
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getVelocityX()

getVelocityY()

  • 获取实体当前速度向量的 Y 分量
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getVelocityY()

getVelocityZ()

  • 获取实体当前速度向量的 Z 分量
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getVelocityZ()

getFireTicks()

  • 获取实体剩余燃烧时间,单位为游戏刻
  • 参数:无
  • 返回值:整数类型
  • 调用示例
实体对象.getFireTicks()

getFreezeTicks()

  • 获取实体当前冰冻时间,单位为游戏刻
  • 参数:无
  • 返回值:整数类型
  • 调用示例
实体对象.getFreezeTicks()

getFallDistance()

  • 获取实体当前累计下落距离,单位为方块
  • 参数:无
  • 返回值:单精度浮点数类型
  • 调用示例
实体对象.getFallDistance()

getTicksLived()

  • 获取实体已存在的游戏刻数
  • 参数:无
  • 返回值:整数类型
  • 调用示例
实体对象.getTicksLived()

isDead()

  • 判断实体是否已经死亡
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isDead()

isValid()

  • 判断服务器当前是否认为该实体有效
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isValid()

isInvulnerable()

  • 判断实体是否处于无敌状态
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isInvulnerable()

isSilent()

  • 判断实体是否处于静音状态
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isSilent()

hasAI()

  • 判断实体是否启用了 AI
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.hasAI()

hasGravity()

  • 判断实体是否受到重力影响
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.hasGravity()

isInWater()

  • 判断实体是否在水中
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isInWater()

isFallFlying()

  • 判断实体是否正在滑翔(鞘翅)
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isFallFlying()

isSwimming()

  • 判断实体是否正在游泳
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isSwimming()

isSleeping()

  • 判断实体是否正在睡觉
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isSleeping()

getPosX()

  • 获取实体的 X 坐标
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getPosX()

getPosY()

  • 获取实体的 Y 坐标
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getPosY()

getPosZ()

  • 获取实体的 Z 坐标
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getPosZ()

getYaw()

  • 获取实体的水平旋转角度
  • 参数:无
  • 返回值:单精度浮点数类型
  • 调用示例
实体对象.getYaw()

getPitch()

  • 获取实体的垂直旋转角度
  • 参数:无
  • 返回值:单精度浮点数类型
  • 调用示例
实体对象.getPitch()

getAir()

  • 获取实体的剩余氧气值
  • 参数:无
  • 返回值:整数类型
  • 调用示例
实体对象.getAir()

isOnGround()

  • 判断实体是否在地面上
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isOnGround()

getHealth()

  • 获取实体当前生命值
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getHealth()

getMaxHealth()

  • 获取实体最大生命值(读取通用最大生命值属性,无该属性时返回 20)
  • 参数:无
  • 返回值:双精度浮点数类型
  • 调用示例
实体对象.getMaxHealth()

isPlayer()

  • 获取实体是否为玩家
  • 参数:无
  • 返回值:布尔类型
  • 调用示例
实体对象.isPlayer()