Structure

Structure is a smaller set of blocks that generates based on defined conditions.

NeoForge 26.1.2NeoForge 1.21.1Data pack 26.1Data pack 1.21.1

Step-by-step guide: how to make structure →

Fields you fill in

Biomes to generate structure in

Use this field to define biomes, where the spawning should happen.

The list can not be empty, as structures need to explicitly define the biomes to which they are applied.

Generation step

This option determines at what stage of world generation the structure should be added.

Ground detection

This parameter controls how the structure ground will be detected.

Example: If we make a structure for a water-based biome, the first motion-blocking block

will generate the structure below the water, as the water is not considered motion blocking block

as the entities can go through it.

The first block detection type will generate the structure above the water.

Blocks to not place

This option will specify which blocks not to place (ignore) when generating the structure.

Select air here in order to not place air blocks of your structure. This will make the structure

integrate better with the environment, but in case of cave based structures, you will likely want to

place the air too.

Jigsaw fallback pool

This parameter determines what jigsaw pool might be used by the current one as a fallback to choose a "terminator" jigsaw part

in cases a part from this one can not be generated in the specified position (not enough space or depth limit reached).

If set to ${modid}:${registryname}_<pool_name>, the game will choose jigsaw parts from pool <pool_name> in this list.

Same pool may be used as well, but if it overlaps with other jigsaw parts of the same structure, it will be ignored.

Maximum distance from main structure

This option controls how far from the main structure may a jigsaw part be generated.

The allowed maximum value is further restricted by terrain adaptation (unless set to "none") as the game needs some space to adjust the ground to the structure being generated.

Jigsaw pool name

This parameter controls the name of this jigsaw pool that might be used by the current one as a fallback in cases it can not be generated in the specified position.

If "Target pool" of jigsaw blocks in your parts is set to ${modid}:${registryname}_<pool_name>, the game will place parts from this pool against them.

Jigsaw pools list

List parts of your jigsaw structure here. Use pools to group parts intended to be placed at similar positions.

Make sure jigsaw blocks in your parts have target pool name set to ${modid}:${registryname}_<pool_name> if they should place jigsaw parts listed below.

Jigsaw generation depth

This parameter defines how many jigsaw part structures can be generated connected

to each other and to the main structure.

Using a fallback pool allows to place one more jigsaw part to complete the structure

in the specified position.

Projection to the terrain

This parameter controls how the structure adapts to the terrain.

Use terrain_matching if you want the structure to match the terrain, like village paths do.

This will shift height of structure on certain parts.

Rigid will place the structure flat as it is.

Structure chunk distribution

Structures are generated in a grid. Those two parameters control the grid:

  • separation - The minimum distance in chunks. Needs to be smaller than spacing.
  • spacing - Roughly the average distance in chunks between two structures in this set.

Example with spacing = 5, separation = 2.

There will be one structure attempt in each 5x5 chunk grid,

and only at X a structure can spawn.

```

.............

..XXX..XXX..X

..XXX..XXX..X

..XXX..XXX..X

.............

.............

..XXX..XXX..X

..XXX..XXX..X

..XXX..XXX..X

```

Structure start height

When enabled, the structure will start at the specified height range.

When this parameter is on, ground detection will be disabled and the

structure will be placed at the specified height range instead.

You can select different height range distributions based on how you want the

chance of the structure to be placed at a certain height to be distributed.

Structure

Current vanilla limit for a single structure is 48x48x48 blocks for performance reasons.

Structure block is a built-in vanilla block that can save builds as .NBT structures.

You can use structural voids to allow the structure to let other blocks override air blocks in your structure

when it is generated. For example, if you want your structure to be buried on the inside you can fill the

inside of the structure with structure voids using the /fill command to allow natural blocks to

spawn where the voids are. Voids will not generate in your structures they are just placeholder blocks to let other

blocks override the area on generation.

Terrain adaptation type

This parameter controls how the terrain adapts to the structure.

  • none - No effect on the terrain.
  • beard_thin - Adds terrain below the structure and removes inside the structure. This is what villages use.
  • beard_box - Stronger version of beard_thin. This is what ancient cities use.
  • bury - Adds terrain completely around the structure. This is what strongholds use.
  • encapsulate - Density will be added all around every piece of a structure. Ideal for structures that need to be entirely covered underground.