LogoArcartX Doc
服务端Aria实体对象

实体效果

实体对象:为实体添加、移除与查询药水效果

  • 以下函数的目标对象为生物实体LivingEntity)。玩家也是生物实体,因此这些函数对玩家目标同样有效。
  • 药水效果名称使用 Minecraft 原版的药水效果 ID(如 SPEEDSLOWNESSREGENERATION 等)。无效的名称会被忽略。

addPotionEffect(id, duration, amplifier)

  • 为实体添加一个药水效果
  • 参数
    • id — 字符串类型,药水效果名称
    • duration — 整数类型,持续时间(tick)
    • amplifier — 整数类型,效果等级(从 0 开始)
  • 返回值:无
  • 调用示例
实体对象.addPotionEffect("SPEED", 200, 1)

参数数量必须为 3 个,否则不会执行。

removePotionEffect(id)

  • 移除实体身上指定的药水效果
  • 参数id — 字符串类型,药水效果名称
  • 返回值:无
  • 调用示例
实体对象.removePotionEffect("SPEED")

clearPotionEffect()

  • 清除实体身上的全部药水效果
  • 参数:无
  • 返回值:无
  • 调用示例
实体对象.clearPotionEffect()

hasPotionEffect(id)

  • 判断实体是否拥有指定的药水效果
  • 参数id — 字符串类型,药水效果名称
  • 返回值:布尔类型
  • 调用示例
实体对象.hasPotionEffect("SPEED")

getPotionEffectDuration(id)

  • 获取实体指定药水效果的剩余持续时间(tick)
  • 参数id — 字符串类型,药水效果名称
  • 返回值:整数类型(无该效果时返回 0)
  • 调用示例
实体对象.getPotionEffectDuration("SPEED")

getPotionEffectAmplifier(id)

  • 获取实体指定药水效果的等级
  • 参数id — 字符串类型,药水效果名称
  • 返回值:整数类型(无该效果时返回 -1)
  • 调用示例
实体对象.getPotionEffectAmplifier("SPEED")

On this page