Class EntitiesUtils

constructor

• new EntitiesUtils(
      dimension: Dimension,
      queryOption: EntityQueryOptions,
  ): EntitiesUtils

  Parameters

  • dimension: Dimension

    实体所在的维度

  • queryOption: EntityQueryOptions

    查询实体的选项

  Returns EntitiesUtils

dimension

queryOption

addEffect

• addEffect(
      effectType: string | string[] | EffectType | EffectType[],
      duration: number,
      effectOption?: EntityEffectOptions,
  ): void

  为批量实体添加效果

  Parameters

  • effectType: string | string[] | EffectType | EffectType[]

    效果的类型

  • duration: number

    效果持续时间，以刻为单位 （20刻=1秒）

    其值必须在范围[0, 20000000]内

  • OptionaleffectOption: EntityEffectOptions

    可选参数，状态效果的具体配置选项

  Returns void

  Since

  Starock 0.6.0 (0.1.0)

applyDamage

• applyDamage(
      amount: number,
      options?: EntityApplyDamageByProjectileOptions | EntityApplyDamageOptions,
  ): void

  对批量实体进行伤害

  Parameters

  • amount: number

    施加的伤害量

  • Optionaloptions: EntityApplyDamageByProjectileOptions | EntityApplyDamageOptions

    关于伤害来源的额外选项，可能会增加额外的效果或造成受伤实体的额外行为

  Returns void

  Since

  Starock 0.6.0 (0.1.0)

applyEffectData

• applyEffectData(data: EffectData | EffectData[]): void

  批量为实体应用 EffectData

  Parameters

  • data: EffectData | EffectData[]

    要应用的 EffectData

  Returns void

clearSlot

• clearSlot(): void

  批量清空实体的容器

  Returns void

  Since

  Starock 0.6.0 (0.1.0)

giveItem

• giveItem(item: ItemStack): void

  批量给予实体物品

  Parameters

  • item: ItemStack

    要给予的物品

  Returns void

  Since

  Starock 0.6.0 (0.1.0)

heal

• heal(amount: number): void

  恢复实体的生命值

  Parameters

  • amount: number

    恢复的生命值，若治愈后生命值超过最大生命值，则重置为最大生命值

  Returns void

  治愈后的生命值

  Throws

  如果实体没有minecraft:health组件，则抛出OccultusSDKError

query

• query(): Entity[]

  查询给定条件下的实体

  Returns Entity[]

tryOperateEntity

• tryOperateEntity(operate: (entity: Entity) => void): void

  尝试对实体进行操作

  Parameters

  • operate: (entity: Entity) => void

    操作函数，接受一个实体作为参数

  Returns void