类 EntityProjectileComponent实验性

The projectile component controls the properties of a projectile entity and allows it to be shot in a given direction. This component is present when the entity has the minecraft:projectile component.

示例: shootArrow.ts

import { DimensionLocation, EntityProjectileComponent } from "@minecraft/server";

function shootArrow(targetLocation: DimensionLocation) {
  const velocity = { x: 0, y: 1, z: 5 };

  const arrow = targetLocation.dimension.spawnEntity("minecraft:arrow", {
    x: targetLocation.x,
    y: targetLocation.y + 2,
    z: targetLocation.z,
  });

  const projectileComp = arrow.getComponent("minecraft:projectile") as EntityProjectileComponent;

  projectileComp?.shoot(velocity);
}

层级 (查看层级一览)

属性

airInertia catchFireOnHurt critParticlesOnProjectileHurt destroyOnProjectileHurt entity gravity hitEntitySound? hitGroundSound? hitParticle? isValid lightningStrikeOnHit liquidInertia onFireTime owner? shouldBounceOnHit stopOnHit typeId componentId

方法

shoot

属性

实验性airInertia

airInertia: number

备注

The fraction of the projectile's speed maintained every tick while traveling through air.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性catchFireOnHurt

catchFireOnHurt: boolean

备注

If true, the entity will be set on fire when hurt. The default burn duration is 5 seconds. This duration can be modified via the onFireTime property. The entity will not catch fire if immune or if the entity is wet.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性critParticlesOnProjectileHurt

critParticlesOnProjectileHurt: boolean

备注

If true, the projectile will spawn crit particles when hit by a player. E.g. Player attacking a Shulker bullet.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性destroyOnProjectileHurt

destroyOnProjectileHurt: boolean

备注

If true, the projectile will be destroyed when it takes damage. E.g. Player attacking a Shulker bullet.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

只读 实验性entity

entity: Entity

备注

拥有此组件的实体。若该实体已被移除，则为 undefined。

The entity that owns this component. The entity will be undefined if it has been removed.

抛出

使用时可能会抛出异常。

抛出

This property can throw when used.

InvalidEntityError

实验性gravity

gravity: number

备注

The gravity applied to the projectile. When the entity is not on the ground, subtracts this amount from the projectile’s change in vertical position every tick. The higher the value, the faster the projectile falls. If negative, the entity will rise instead of fall.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

可选 实验性hitEntitySound

hitEntitySound?: string

备注

The sound that plays when the projectile hits an entity.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

可选 实验性hitGroundSound

hitGroundSound?: string

备注

The sound that plays when the projectile hits a block.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

可选 实验性hitParticle

hitParticle?: string

备注

The particle that spawns when the projectile hits something.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

只读 实验性isValid

isValid: boolean

备注

返回组件是否有效。若组件的拥有者有效，并且组件需要的任何 额外验证也通过，则该组件被认为是有效的。

Returns whether the component is valid. A component is considered valid if its owner is valid, in addition to any addition to any additional validation required by the component.

实验性lightningStrikeOnHit

lightningStrikeOnHit: boolean

备注

If true and the weather is thunder and the entity has line of sight to the sky, the entity will be struck by lightning when hit. E.g. A thrown Trident with the Channeling enchantment.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性liquidInertia

liquidInertia: number

备注

The fraction of the projectile's speed maintained every tick while traveling through a liquid.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性onFireTime

onFireTime: number

备注

Duration in seconds that the entity hit will be on fire for when catchFireOnHurt is set to true.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

可选 实验性owner

owner?: Entity

备注

The owner of the projectile. This is used to determine what the projectile can collide with and damage. It also determines which entity is assigned as the attacker.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性shouldBounceOnHit

shouldBounceOnHit: boolean

备注

If true, the projectile will bounce off mobs when no damage is taken. E.g. A spawning wither.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

实验性stopOnHit

stopOnHit: boolean

备注

If true, the projectile will stop moving when an entity is hit as thought it had been blocked. E.g. Thrown trident on hit behavior.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

只读 实验性typeId

typeId: string

备注

组件的标识符。 Identifier of the component.

静态 只读 实验性componentId

componentId: "minecraft:projectile" = 'minecraft:projectile'

方法

shoot

  • shoot(velocity: Vector3, options?: ProjectileShootOptions): void
  • 实验性

    参数

    • velocity: Vector3

      The velocity to fire the projectile. This controls both the speed and direction which which the projectile will be shot.

    • 可选options: ProjectileShootOptions

      Optional configuration for the shoot.

    返回 void

    备注

    Shoots the projectile with a given velocity. The projectile will be shot from its current location.

    无法在只读模式下调用此函数，详见 WorldBeforeEvents。

    抛出

    Throws if the component or entity no longer exist.

显示设置

成员可见性

目录

属性
方法