Spawn Conditions

Customizable player spawn conditions.

Configuration

Lists

Entries are ids like modid:name, or tags with a # in front like #modid:name. Anything a mod adds works the same as a vanilla entry. The deny list is checked first, so an entry in both lists is denied.

Fluid lists work the other way round from the biome and block lists. An empty fluidAllowList means no fluid spawning, which is what vanilla does. Use tags for fluids because a fluid has a state for still and flowing, so #minecraft:water will do both while minecraft:water will only touch the still state.

The block lists check whatever the player ends up standing on.

Ground requirement

Leaves have a full collision box, so they already count as ground under FULL_FACE.

Cave spawns

maxY is what makes cave spawns possible. The search always runs down from maxY, so setting it below the surface starts the search underground and takes the first floor it finds:

"placement": {
  "maxY": -10,
  "minY": -60,
  "requiredHeadroom": 2
}

requiredHeadroom is needed here. Without it the search stops on the first full block at maxY, which is usually stone, and spawns the player inside it. With 2 the search skips solid rock and keeps going down until it finds a floor with air above it. Add "biomeAllowList": ["minecraft:lush_caves"] to pick a cave biome. Biomes are 3D, so the check runs at the spawn spot, not at the surface.

Same Dimension Respawn

stayInDimensions keeps players in a dimension when they die there, like how RLCraft does the Lost Cities.

A player who dies in the Lost Cities respawns somewhere else in the Lost Cities. spawnRadius gamerule also applies. Every death there keeps them there until they get back to the overworld.

A spawn point set inside a listed dimension is used as normal. Put the same dimension in preventSpawnSettingDimensions to prevent someone setting their spawn.

The spread only works in dimensions with a sky, like the overworld or the Lost Cities. In a dimension without one, like the Nether or the End, the player is put at the world spawn x and z.

Notes

worldSpawn sets the point everything else is measured from. It only runs for the overworld of a new world. A world that already exists has saved its spawn.

The vanilla spawnRadius gamerule can be used to specify spawn radius in blocks around 0,0. /gamerule spawnRadius 2000. If you want this to occur on every world, use the Global GameRules mod.

preventSpawnSetting stops beds and respawn anchors saving a spawn point, so every death goes back through the rules you set. /spawnpoint still works.

spawnBlockedMessage This is what the player sees above their hotbar when they cannot set their spawn. Put & in front of a color or format code, like &c for red, &l for bold or &r to reset. Leave the option empty for no message.

Every default is vanilla, so a new config with enabled on changes nothing until you turn something on.

For those who specifically want RLCraft style spawning, put #minecraft:water in placement.fluidAllowList, set placement.liquidLanding to FLOOR so players can spawn on the sea bed, and then add /gamerule spawnRadius 20000 using the Global GameRules mod.

FAQ

Found a bug? 

Submit a issue request on the Github issues page with:
- A description of the problem.
- Any relevant logs.
- The version of Spawn Conditions.
- What loader you are using (ex: Forge 1.20.1, NeoForge 1.21.1)