Worldshape Mod — Reference

Structure Registration

To register a structure, you must create a JSON file in the structure_spawners/ folder. The name of this file will be the internal ID of the structure.

Configuration Format

Below is the standard structure for a spawner JSON file:

{
 "template": {
 "single": "namespace:structure_name"
 },
 "placement": {
 "type": "surface",
 "minY": 60,
 "maxY": 120,
 "fluidSurface": false
 },
 "averageSpacing": 32,
 "minimumSpacing": 16,
 "seed": 12345,
 "avoidOthers": true,
 "biomes": [ "minecraft:plains", "#minecraft:is_forest" ],
 "dimensions": [ "minecraft:overworld" ]
}

Parameter Definitions

Parameter	Type	Description
`template`	Object	Defines the source. Use `"single": "path"` for a single NBT or `"pool": "path"` for a Jigsaw pool.
`averageSpacing`	Integer	The average distance (in chunks) between spawn attempts.
`minimumSpacing`	Integer	The minimum distance (in chunks) between two structures of this type.
`seed`	Integer	A unique salt for the placement algorithm to ensure consistent generation.
`avoidOthers`	Boolean	If true, the structure will check for other Worldshape structures and avoid overlapping.
`biomes`	Array	A list of biome IDs or tags (prefixed with `#`) where the structure can spawn.
`dimensions`	Array	A list of dimension IDs where the structure is allowed.