> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/cn-er/pei-zhi/info-of-abilities/projectiles.md).

# 弹射物能力

本页面会将每一种已注册能力作为完整条目进行说明。所有条目也支持[能力](/cn-er/pei-zhi/info-of-abilities.md)页面中介绍的通用能力字段。

## 本页面的注册键

* `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。 |

### 示例

```yaml
type: launch_projectile
source: SOURCE
entity-type: SPLASH_POTION
speed: 1.3
count: 3
spread-degrees: 12
inherit-powers: true
potion-effects:
  poison:
    potion: POISON
    duration: 100
    amplifier: 0
```

### 行为与限制

* 存在位于同一世界的生物实体目标时会瞄准该目标；否则使用发射者的视线方向。
* 如果生成结果不是投射物，该实体会被移除；潜影贝导弹会接收当前目标。
* `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。 |

### 示例

```yaml
type: shulker_bullet
entity-type: SHULKER_BULLET
target: SOURCE
speed: 1.2
```

### 行为与限制

* 存在当前上下文目标时，生成的潜影贝导弹会自动将其设为目标。
* 其他所有行为均与本仓库中的 `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` | 自动追踪期间是否禁用重力。           |

### 示例

```yaml
type: homing_projectile
radius: 24
strength: 0.18
max-angle: 90
lead: 0.5
max-ticks: 120
```

### 行为与限制

* 投射物会保留之前仍然有效的目标，只在需要时重新搜索。
* 会忽略创造模式和旁观模式玩家。
* 目标优先级依次为：现有锁定目标、来源怪物当前目标、附近最佳候选目标。
* 过期时会返回取消请求，使投射物追踪可以停止。

***