# 自定义生成规则

## 什么是自定义生成规则？

自定义生成规则与自定义事件配套，允许服主配置事件生成的自定义怪物的生成规则。

## 示例生成规则

自定义生成规则的配置都在 `custmspawns` 文件夹，一个生成规则可以被多个事件同时使用，所以你不必为每个事件的同样怪物一个一个单独设置生成规则。

这是一个生成规则示例：

```
isEnabled: true
validWorldTypes:
- NORMAL
- CUSTOM
bypassWorldGuard: false
isSurfaceSpawn: true
```

### 必须配置选项

无。当没有配置选项时，自定义怪物将会随机生成。

### 可选配置选项

#### `isEnabled`

`isEnabled` 设置是否启用该自定义生成规则。

#### `lowestYLevel`

`lowestYLevel` 设置该自定义怪物生成的最低坐标，例如 `lowestLevel: 64`。

#### `highestYLevel`

`highestYLevel` 设置该自定义怪物生成的最高坐标，例如 `highestYLevel: 100`。

#### `validWorlds`

`validWorlds` 设置自定义怪物将会生成的世界，例如：

```
validWorlds:
- world
- world_nether
```

#### `validWorldEnvironment`

`validWorldEnvironment` 设置自定义怪物将会生成的维度，有 NORMAL（主世界）、NETHER（下界）和 END（末地）。

```
validWorldTypes:
- NORMAL 
```

#### `validBiomes`

`validBiomes` 设置自定义怪物将会生成的生物群系。

```
validBiomes:
- PLAINS
```

#### `earliestTime`

`earliestTime` 设置自定义怪物将会生成的最早时间，以一天为完整值， tick 为单位，例如 `earliestTime: 100`。

#### `latestTime`

`latestTime` 设置自定义怪物将会生成的最晚时间，以一天为完整值， tick 为单位，例如 `latestTime: 20000`。

#### `moonPhase`

`moonPhase` 设置自定义怪物生成的月周期，例如 `moonPhase: FULL_MOON`。

可以填写： `FULL_MOON` , `WANING_GIBBOUS` , `LAST_QUARTER` , `WANING_CRESCENT` , `NEW_MOON` , `WAXING_CRESCENT` , `FIRST_QUARTER` , `WAXING_GIBBOUS`

#### `bypassWorldGuard`

`bypassWorldguard` 设置自定义怪物生成是否忽视 WorldGuard 的保护，例如 `bypassWorldGuard: true`。

#### `canSpawnInLight`

`canSpawnInLight` 设置自定义怪物是否在有亮光的地方生成，例如 `canSpawnInLight: true`。

#### `isSurfaceSpawn`

`isSurfaceSpawn` 设置自定义怪物是否在地表生成，例如 `isSurfaceSpawn: true`。

#### `isUndergroundSpawn`

`isUndergroundSpawn` 设置自定义怪物是否在地下生成，例如 `isUndergroundSpawn: true`。