# 自定义小兵

## 什么是自定义小兵？

自定义小兵是一些很强大的自定义怪物召唤的一种生物，其实本质上还是自定义怪物，它们的作用是让游戏增加一些难度。

## 示例小兵

首先，我们需要进行如下步骤：

1. 创建将会生成小兵的自定义怪物，下文直接称之为 BOSS。
2. 再创建小兵的自定义怪物。
3. 在 BOSS 的怪物配置文件中设置小兵属性。

### 设置小兵属性

你刚刚创建的 BOSS 怪物配置文件应该如下所示：

```
isEnabled: true
entityType: ENDER_DRAGON
name: $eventBossLevel &eBinder of Worlds
level: 200
powers:
- ender_dragon_arrow_bombardment.yml
```

我们可以在能力（powers）选项下再新增如下的能力：

```
- summonable:summonType=ON_COMBAT_ENTER:filename=binder_of_worlds_phase_1_parkour_reinforcement.yml
```

这时你的 BOSS 配置文件应该像这样：

```
isEnabled: true
entityType: ENDER_DRAGON
name: $eventBossLevel &eBinder of Worlds
level: 200
powers:
- ender_dragon_arrow_bombardment.yml
- summonable:summonType=ON_COMBAT_ENTER:filename=binder_of_worlds_phase_1_parkour_reinforcement.yml
```

现在我们就已经真的做好一个小兵了，但是你会发现你还是一头雾水，别急，下面将一一介绍。

## 配置组成

我们可以看到我们新增的有关小兵一行能力由如下字段组成，每个字段使用 `;` 符号分开，字段的键与值使用 `=` 符号分开，如果没有值则不需要：

### 必须字段

#### summonable

 `summonable` 只是代表让 EliteMobs 知道这一行能力是 BOSS 召唤小兵，它是必须的。

#### summonType

`summonType=生成类型` **是代表小兵召唤类型，可以填写：**

* `summonType=ONCE` 在第一次击打 BOSS 时召唤。
* `summonType=ON_HIT` 每次击打 BOSS 都会召唤。
* `summonType=ON_COMBAT_ENTER` 当 BOSS 进入战斗状态时召唤。
* `summonType=ON_COMBAT_ENTER_PLACE_CRYSTAL` 当 BOSS 进入战斗放置末影水晶（只是给末影龙使用的）。

*进入战斗状态往往在游戏内表现为玩家进入 BOSS 的感应范围内后。*

#### filename

`filename=filename.yml` **是代表小兵的自定义怪物文件，但当** `summonType=ON_COMBAT_ENTER_PLACE_CRYSTAL` **时此字段不需要，因为这时已经指代生成“末影水晶”小兵。**

### 可选字段

#### chance

`chance=浮点类型选项` 是代表召唤小兵的几率，只在 `summonType` 为 `ONCE` 或者 `ON_HIT` 时生效。例如 `chance=0.2` 代表有 20% 几率召唤小兵。

#### location

`location=x,y,z` 是代表小兵召唤位置的较于 BOSS 当前的偏移坐标。

* 对于非区域 BOSS，则较于 BOSS 的当前坐标的偏移。例如当你设置为 `location=0,10,0` 时代表在 BOSS 当前位置上方 10 格召唤小兵，不是在世界坐标 0,10,0 位置召唤小兵！
* 对于区域 BOSS，则较于 BOSS 的生成位置点坐标。同样是上面示例，这时则代表在 BOSS 生成位置点的坐标。
* 对于末影龙，始终是四周的塔生成小兵。

#### lightningRod

`lightningRod=布尔值类型选项` 是代表末影水晶爆炸是否有一定的延迟时间，只在 `summonType=ON_COMBAT_ENTER_PLACE_CRYSTAL` 时有效。

#### inheritAggro

`inheritAggro=布尔值类型选项` 是代表小兵是否主动攻击对 BOSS 威胁最大的玩家。

#### amount

`amount=整数类型选项` 是代表召唤小兵的数量。

#### spawnNearby

`spawnNearby=布尔值类型选项` 是代表是否在 BOSS 周围生成小兵而不是上面的固定偏移位置，这可以有效解决因设置错误导致小兵卡墙问题。

#### inheritLevel

`inheritLevel=布尔值类型选项` 是代表小兵是否继承 BOSS 的怪物等级。

#### 示例

```
isEnabled: true
entityType: ENDER_DRAGON
name: $eventBossLevel &eBinder of Worlds
level: 200
powers:
- ender_dragon_arrow_bombardment.yml
- summonable:summonType=ON_COMBAT_ENTER:filename=test_boss.yml:spawnNearby=true:inheritAggro=true:inheritLevel=true
- summonable:summonType=ON_COMBAT_ENTER_PLACE_CRYSTAL:location=-80,10,0:lightningRod=true
```