Creating Spawns

What are Custom Spawns?

Custom Spawns are used by Events and global reinforcements to set how, where and when an event should spawn the boss for that event.

Events and global reinforcements set which spawn they are using by writing down its filename.

Creating Custom Spawns

Custom Spawns go into the customspawns folder. One Custom Spawn can be used by several events at the same time, so you don't have to create one per event.

Here is an example Custom Spawn:

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

Making an Anywhere Spawn

To make a spawn that can occur anywhere, your configuration should resemble the following:

isEnabled: true
canSpawnInLight: true

This configuration allows mobs to spawn in any location, in any world, at any time, and during any moon phase.

If you're interested in creating a more customized spawn, keep reading below.

Values

---

isEnabled

Sets if the spawn is enabled.

Key	Values	Default
isEnabled	Boolean	true

Example

isEnabled: true

---

lowestYLevel

Sets the lowest y level (map height) used.

Key	Values	Default
lowestYLevel	Integer	0

Example

lowestYLevel: 0

---

highestYLevel

Sets the lowest y level (map height) used.

Key	Values	Default
highestYLevel	Integer	320

Example

highestYLevel: 320

---

validWorlds

Sets the list of the worlds where the custom spawn can happen. This setting can be left out to allow all your worlds to be valid.

Key	Values	Default
validWorlds	String List	none

Example

validWorlds:
- WORLD
- FUN_LAND

If you want all your worlds to be valid you can just not use the setting or format it like this:

validWorlds: []

---

validWorldEnvironments

Sets the list of valid world environments where the custom spawn can happen. This setting can be left out to allow all environments to be valid.

Key	Values	Default
validWorldEnvironments	Environment List	none

Example

validWorldEnvironments:
- FLAT
- LARGE_BIOMES

If you want all environments to be valid you can just not use the setting or format it like this:

validWorldEnvironments: []

---

validBiomesV2

Sets the list of valid biomes where the custom spawn can happen. This setting can be left out to allow all biomes to be valid. This setting used to be called validBiomes in older versions of EM.

Key	Values	Default
validBiomes	Biome List	none

Example

validBiomes:
- DESERT
- MUSHROOM_FIELDS

If you want all environments to be valid you can just not use the setting or format it like this:

validBiomes: []

---

earliestTime

Sets the earliest in-game time at which the custom spawn can happen.

Key	Values	Default
earliestTime	Integer	0

Example

earliestTime: 0

---

latestTime

Sets the earliest in-game time at which the custom spawn can happen.

Key	Values	Default
latestTime	Integer	24000

Example

latestTime: 24000

---

moonPhase

Sets the earliest in-game time at which the custom spawn can happen.

Key	Values	Default
moonPhase	Special [1]	24000

Example

moonPhase: 24000

Special [1]

Expand Table

Moon Phase	Preview
NEW_MOON	🌑
WAXING_CRESCENT	🌒
FIRST_QUARTER	🌓
WAXING_GIBBOUS	🌔
FULL_MOON	🌕
WANING_GIBBOUS	🌖
WANING_CRESCENT	🌘

---

bypassWorldGuard

Sets if the custom spawn will bypass protection systems such as WorldGuard.

Key	Values	Default
bypassWorldGuard	Boolean	false

Example

bypassWorldGuard: false

---

canSpawnInLight

Specifies whether the custom spawn can occur on blocks illuminated by light sources.

Key	Values	Default
canSpawnInLight	Boolean	false

Example

canSpawnInLight: false

---

isSurfaceSpawn

Sets if the custom spawn can only happen at the surface of a world.

Key	Values	Default
isSurfaceSpawn	Boolean	false

Example

isSurfaceSpawn: false

---

isUndergroundSpawn

Sets if the custom spawn can only happen underground.

Key	Values	Default
isUndergroundSpawn	Boolean	false

Example

isUndergroundSpawn: false