服务端Aria实体对象
实体效果
实体对象:为实体添加、移除与查询药水效果
- 以下函数的目标对象为生物实体(
LivingEntity)。玩家也是生物实体,因此这些函数对玩家目标同样有效。 - 药水效果名称使用 Minecraft 原版的药水效果 ID(如
SPEED、SLOWNESS、REGENERATION等)。无效的名称会被忽略。
addPotionEffect(id, duration, amplifier)
- 为实体添加一个药水效果
- 参数:
id— 字符串类型,药水效果名称duration— 整数类型,持续时间(tick)amplifier— 整数类型,效果等级(从 0 开始)
- 返回值:无
- 调用示例
参数数量必须为 3 个,否则不会执行。
removePotionEffect(id)
- 移除实体身上指定的药水效果
- 参数:
id— 字符串类型,药水效果名称 - 返回值:无
- 调用示例
clearPotionEffect()
- 清除实体身上的全部药水效果
- 参数:无
- 返回值:无
- 调用示例
hasPotionEffect(id)
- 判断实体是否拥有指定的药水效果
- 参数:
id— 字符串类型,药水效果名称 - 返回值:布尔类型
- 调用示例
getPotionEffectDuration(id)
- 获取实体指定药水效果的剩余持续时间(tick)
- 参数:
id— 字符串类型,药水效果名称 - 返回值:整数类型(无该效果时返回 0)
- 调用示例
getPotionEffectAmplifier(id)
- 获取实体指定药水效果的等级
- 参数:
id— 字符串类型,药水效果名称 - 返回值:整数类型(无该效果时返回 -1)
- 调用示例
