For the complete documentation index, see llms.txt. This page is also available as Markdown.

🏹弹射物能力

本页面会将每一种已注册能力作为完整条目进行说明。所有条目也支持能力页面中介绍的通用能力字段。

本页面的注册键

  • launch_projectile

  • shulker_bullet

  • homing_projectile


launch_projectile

**用途:**由一个生物实体发射者生成并配置一个或多个投射物实体。

**上下文:**配置了 source 时,它用于选择发射者;否则使用 target 选择发射者。TARGET 仍然作为瞄准目标。

字段

字段
默认值
说明

entity-type

ARROW

可生成且实现 Projectile 的 Bukkit 实体类型。

speed

1.5

发射速度。

extra-y

0

额外添加的 Y 轴分量。

count

1

投射物数量,最小值为 1。

spread-degrees

0

扇形散布的最大角度;多个投射物会均匀分布。

spawn-offset

0

从发射者眼睛位置沿前方移动的生成偏移量。

damage

未设置

保存到投射物上的能力伤害覆盖值。

inherit-powers

false

是否追踪投射物,以继续执行投射物 Tick 和命中触发器。

fireball-yield

1.0

爆炸型投射物的爆炸威力。

fireball-incendiary

true

火球是否能够引燃方块。

potion-type

未设置

投掷药水使用的基础药水类型。

potion

未设置

未配置 potion-effects 时使用的单个自定义效果。

duration

100

单个自定义效果的持续时间。

amplifier

0

单个自定义效果的倍率。

potion-effects

未设置

自定义效果映射;每项可以配置 potion、duration 和 amplifier。

示例

行为与限制

  • 存在位于同一世界的生物实体目标时会瞄准该目标;否则使用发射者的视线方向。

  • 如果生成结果不是投射物,该实体会被移除;潜影贝导弹会接收当前目标。

  • inherit-powers 会使用当前玩家、触发物品和装备槽位追踪投射物。


shulker_bullet

用途:launch_projectile 的兼容性别名。

**上下文:**使用与 launch_projectile 相同的发射者选择、瞄准目标和字段。

字段

字段
默认值
说明

entity-type

ARROW

通常设置为 SHULKER_BULLET

speed

1.5

发射速度。

extra-y

0

额外添加的 Y 轴分量。

count

1

投射物数量,最小值为 1。

spread-degrees

0

扇形散布的最大角度;多个投射物会均匀分布。

spawn-offset

0

从发射者眼睛位置沿前方移动的生成偏移量。

damage

未设置

保存到投射物上的能力伤害覆盖值。

inherit-powers

false

是否追踪投射物,以继续执行投射物 Tick 和命中触发器。

fireball-yield

1.0

爆炸型投射物的爆炸威力。

fireball-incendiary

true

火球是否能够引燃方块。

potion-type

未设置

投掷药水使用的基础药水类型。

potion

未设置

未配置 potion-effects 时使用的单个自定义效果。

duration

100

单个自定义效果的持续时间。

amplifier

0

单个自定义效果的倍率。

potion-effects

未设置

自定义效果映射;每项可以配置 potion、duration 和 amplifier。

示例

行为与限制

  • 存在当前上下文目标时,生成的潜影贝导弹会自动将其设为目标。

  • 其他所有行为均与本仓库中的 launch_projectile 实现相同。


homing_projectile

**用途:**引导当前投射物飞向已经锁定或新选中的生物实体目标。

**上下文:**要求 SKILL 是有效投射物;通常用于投射物 Tick 触发器。

字段

字段
默认值
说明

radius

16

搜索或锁定目标的最大半径。

strength

0.2

转向混合强度,数值限制在 0.01..1

require-line-of-sight

false

是否要求目标处于视线范围内。

max-angle

360

以当前飞行方向为中心的最大锥形半角。

lead

0

目标运动预测系数。

max-ticks

100

最大执行次数;填写非正数时禁用过期。

remove-on-expire

true

过期时是否移除投射物。

disable-gravity

false

自动追踪期间是否禁用重力。

示例

行为与限制

  • 投射物会保留之前仍然有效的目标,只在需要时重新搜索。

  • 会忽略创造模式和旁观模式玩家。

  • 目标优先级依次为:现有锁定目标、来源怪物当前目标、附近最佳候选目标。

  • 过期时会返回取消请求,使投射物追踪可以停止。


最后更新于