Spawn Condition

A spawn condition is used during spawn selection to decide whether a specific SpawnDetail is compatible with the given SpawningContext.

A spawn condition JSON has many common properties that apply to all contexts, and then there are sub-types that apply to specific contexts. For example, a submerged context has information about depth, and so a SubmergedSpawningCondition is required to make a condition that checks that depth value for a spawn. For all values that are left blank or empty, that value is not checked by the condition. For example, an empty biome list means the biome won't affect the spawning and an unset moonPhase means the moon won't affect the spawning.

Property Name	Description
dimensions	A list of dimension IDs, such as minecraft:overworld or minecraft:the_nether. This is technically called a dimension effect.
biomes	A list of biome based conditions. These conditions are all written as text. If the condition starts with a # such as #pokemoncobbled:is_arid, it is understood as a biome tag condition, otherwise checked as a biome ID such as minecraft:forest.
structures	A list of structure IDs, such as minecraft:stronghold or minecraft:desert_pyramid. Allows Pokémon to spawn in the chunks of the listed structures.
moonPhase	The phase of the moon required for the spawn. This is an integer between 0 and 7 according to the Minecraft Wiki.
canSeeSky	Whether or not the spawning context must have a direct route to the sky above it, as a true/false. Fluids do not count as a sky obstruction.
minX	The minimum X coordinate that the spawning context may have.
minY	The minimum Y coordinate that the spawning context may have.
minZ	The minimum Z coordinate that the spawning context may have.
maxX	The maximum X coordinate that the spawning context may have.
maxY	The maximum Y coordinate that the spawning context may have.
maxZ	The maximum Z coordinate that the spawning context may have.
minLight	The lowest acceptable light level at the spawning context's location. This is an integer between 0 and 15 inclusive.
maxLight	The highest acceptable light level at the spawning context's location. This is an integer between 0 and 15 inclusive.
minSkyLight	The lowest acceptable sky light level at the spawning context's location. This is an integer between 0 and 15 inclusive.
maxSkyLight	The highest acceptable sky light level at the spawning context's location. This is an integer between 0 and 15 inclusive.
timeRange	The time range that is acceptable. This can either be text for registered time ranges like 'day', 'night', 'morning', or it can be a comma separated list of tick ranges such as '0-1200,2000-3000'. It can also be a combination of both.
isRaining	Whether it must be raining or not raining, as a true/false.
isThundering	Whether it must be thundering or not thundering, as a true/false. Note that if it's raining regularly, it will not count as thundering. If it is thundering, it will count as both thundering and raining.
labels	The required labels on the spawn for it to be acceptable. This can be either a condition that requires all of the specified labels to be met, or just one of them. This is dictated by the labelMode value.
labelMode	What kind of check will be applied for the labels. This is either ANY, meaning that any matching label from the condition's label list will suffice, or ALL, which requires every label mentioned in the condition to exist in the spawn.

Area spawning conditions are a sub-type of spawning condition and adds more properties that will apply to all area based spawning contexts (which is all world spawning).

Property Name	Description
minWidth	The smallest acceptable horizontal space around an area spawning context. Should be used to protect spawns from occurring where they will immediately suffocate and die.
maxWidth	The largest acceptable horizontal space around an area spawning context.
minHeight	The smallest acceptable amount of vertical space above an area spawning context. Should be used to protect spawns from occurring where they will immediately suffocate and die.
maxHeight	The largest acceptable amount of vertical space above an area spawning context.
neededNearbyBlocks	A list of block identifiers such as minecraft:cobblestone, at least one of which must be nearby. What counts as nearby is dependent on the config option that dictates how far out it should look.

Grounded spawning conditions are a sub-type of area spawning condition and adds more properties that will apply to the grounded context.

Property Name	Description
neededBaseBlocks	A list of block identifiers such as minecraft:cobblestone, at least one of which must be the base block that the spawn is occurring on.

Submerged spawning conditions are a sub-type of area spawning condition and adds more properties that will apply to the submerged contexts, those being underlava and underwater.

Property Name	Description
minDepth	The minimum number of blocks that may be beneath the submerged spawning context.
maxDepth	The maximum number of blocks that may be beneath the submerged spawning context.
fluidIsSource	Whether or not the fluid block the spawn is occurring in must be a source for the fluid.
fluidBlock	The type of fluid it must be spawning in. This is as a translated name, such as water.