Minecraft:Structure set

A structure set is used to determine the position of structures in the world during world generation. They are configured using Minecraft:JSON files stored within a Minecraft:data pack in the path Template:Cd or an Minecraft:add-on in the path Template:Cd. Structure sets are not referenced in a dimension or biome. Instead, the existence of the resource is enough to make the structures generate. The valid biomes of a structure are determined by the structure itself (see Minecraft:Structure/JSON format).

The structure sets uses the Template:Nbt to determine the placement of structures. For any position a random structure is selected from the Template:Nbt list. If the selected structure can't be placed because its not in a valid biome, a different structure is selected.

JSON format

Template:El:

• Template:Nbt: Root object.
  • Template:Nbt: (Required, but can be empty) The structures that may be placed. One configured structure feature shouldn't be included by two structure sets.
    • Template:Nbt: A structure to be placed.
      • Template:NbtTemplate:Nbt: Template:Json ref/structure — The structure to be placed.
      • Template:Nbt: Determines the chance of it being chosen over others. Must be a positive integer.
  • Template:Nbt: How the structures should be placed.
    • Template:Nbt: A number that assists in randomization; see Template:W. Must be a non-negative integer.
    • Template:Nbt: (Optional, default to 1.0) Probability to try to generate if other conditions below are met. Values between 0.0 to 1.0 (inclusive). Setting it to a number does not mean one structure is generated this often, only that the game attempts to generate one; biomes or terrain could lead to the structure not being generated.
    • Template:Nbt: (Optional, defaults to Template:Cd) Provides a random number generator algorithm for frequency. One of Template:Cd (the random number depends on the seed, position and Template:Nbt, due to Template:Bug removes lines of structure attempts in Z cardinal direction), Template:Cd (the random number depends only on the seed and position, and randomness only occurs when the locations differ greatly), Template:Cd (same as Template:Cd, but with fixed salt: 10387320, not affected by Template:Bug) and Template:Cd (the random number depends only on seed and position).
    • Template:Nbt: Specifies that it cannot be placed near certain structures.
      • Template:Nbt: Value between 1 and 16 (inclusive).
      • Template:Nbt: A structure set ID.
    • Template:Nbt: (optional, defaults to [0,0,0]) The chunk coordinate offset given when using Template:Cmd.
      • Template:Nbt: X. Value between -16 and 16 (inclusive).
      • Template:Nbt: Y. Value between -16 and 16 (inclusive).
      • Template:Nbt: Z. Value between -16 and 16 (inclusive).
    • Template:Nbt: One of Template:Cd or Template:Cd.
    • Additional fields depending on value of Template:Nbt, see Placement types.

Template:El:

• Template:Nbt
  • Template:Nbt: The version of the game to run this file as. Can be a version above 1.21.20.
  • Template:Nbt:
    • Template:Nbt
      • Template:Nbt: The identifier used for the structure set.
    • Template:Nbt: How the structures should be placed.
      • Template:Nbt: The type of spread. Can be minecraft:random_spread.
      • Template:Nbt: A random 8 number sequence used for randomizing placement similarly to a world seed.
      • Template:Nbt: Size in chunks of the grid space used to place the structure
      • Template:Nbt: Padding between placements of set placements.
      • Template:Nbt: Algorithm used when placing structures. Can be linear or triangular.
    • Template:Nbt: Weighted list of structures that can be placed.
      • Template:Nbt: A structure to be placed.
        • Template:Nbt: A structure identifier.
        • Template:Nbt: Determines the chance of it being chosen over others. Must be a positive integer.

Placement types

The placement type determines how the structures are spread in a world. There are two placement types.

random_spread

File:Random spread distribution plot.png

Orange line is Template:Cd distribution of offset value and blue line is Template:Cd

Structures are spread evenly throughout the entire world. In vanilla, this placement type is used for most structures (like Minecraft:bastion remnants or Minecraft:swamp hutsTemplate:Only). Starting from chunk 0 0 and moving outwards Template:Nbt number of chunks, a grid of initial positions is created. After that the offset is applied to each position by X and Z separately based on the additional fields. Note that it attempts to generate a structure for each spacing×spacing chunk region from the initial grid.

• additional fields:
  • Template:Nbt: (optional, defaults to Template:Cd) One of Template:Cd or Template:Cd. Template:Cd sets offset to a random value between 0 and Template:Cd (inclusive). Template:Cd takes the sum of 2 random numbers between 0 and Template:Cd (inclusive) then divides that sum by 2, rounding down to nearest integer. This value results in less random offset, where values have a much higher chance to be closer to the middle of the distribution, than to the sides.
  • Template:Nbt: Average distance (in chunks) between two neighboring generation attempts. Value between 0 and 4096 (inclusive).
  • Template:Nbt: Minimum distance (in chunks) between two neighboring attempts. Value between 0 and 4096 (inclusive). Has to be strictly smaller than Template:Nbt. The maximum distance of two neighboring generation attempts is Template:Cd.

concentric_rings

File:Strongholds 1.9.svg

Concentric rings, used in strongholds

A fixed number of structures are placed in concentric rings around the origin of the world. In vanilla, this placement is only used for Minecraft:strongholds.

• additional fields:
  • Template:Nbt: The thickness of a ring plus the thickness of a gap between two rings. Ring and gap are equal in thickness. Value between 0 and 1023 (inclusive). Unit is 6 chunks
  • Template:Nbt: The total number of generation attempts in this dimension. Value between 1 and 4095 (inclusive).
  • Template:NbtTemplate:Nbt: Template:Json ref/biome — Biomes in which the structure is likely to be generated. After choosing the initial position of generation, a search in a square with a radius of 112 blocks begins. It proceeds from -X to +X, from -Z to +Z in 4×4 squares. When a position inside a biome from Template:NbtTemplate:Nbt is found, it is considered the new position. If multiple positions are found, one is chosen randomly. If no positions are found, the initial position is used.
  • Template:Nbt: How many attempts are on the closest ring to spawn. Value between 0 and 1023 (inclusive). The number of attempts on the Nth ring is: Template:Cd, until the number of attempts reaches the total Template:Nbt.

Default structure sets

Structure set	Structures	Template:Tooltip	Template:Tooltip	Salt	Spread type	Notes
abandoned_camp	Template:EnvLink	8	37 Template:Only, 34 Template:Only	91231127	Template:Cd Template:Only, Template:Cd Template:Only	All types of abandoned camp are in the structure set
ancient_cities Template:Only	Template:EnvLink	8	24	20083232	Template:Cd
buried_treasures Template:Only	Template:EnvLink	0	1	0	Template:Cd	Probability of 1%, locate_offset of x:9, y:0, z:9
desert_pyramids Template:Only	Template:EnvLink	8	32	14357617	Template:Cd
end_cities Template:Only	Template:EnvLink	11	20	10387313	Template:Cd
igloos Template:Only	Template:EnvLink	8	32	14357618	Template:Cd
jungle_temples Template:Only	Template:EnvLink	8	32	14357619	Template:Cd
mineshafts Template:Only	Template:EnvLink Template:EnvLink	0	1	0	Template:Cd	Probability of 0.4%
nether_complexes Template:Only	40% Template:EnvLink 60% Template:EnvLink	4	27	30084232	Template:Cd
nether_fossils Template:Only	Template:EnvLink	1	2	14357921	Template:Cd
ocean_monuments Template:Only	Template:EnvLink	5	32	10387313	Template:Cd
ocean_ruins Template:Only	Template:EnvLink	8	20	14357621	Template:Cd
pillager_outposts Template:Only	Template:EnvLink	8	32	165745296	Template:Cd	Probability of 20%, exclusion zone of 10 chunks from any village
ruined_portals Template:Only	Template:EnvLink	15	40	34222645	Template:Cd
shipwrecks Template:Only	Template:EnvLink	4	24	165745295	Template:Cd
strongholds Template:Only	Template:EnvLink			0	N/A	Concentric rings distance=32 count=128 spread=3
swamp_huts Template:Only	Template:EnvLink	8	32	14357620	Template:Cd
trail_ruins	Template:EnvLink	8	34	83469867	Template:Cd
trial_chambers	Template:EnvLink	12	34	94251327	Template:Cd	The bedrock values are unknown but the structure set can be overwritten.
villages Template:Only	Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink	8	34	10387312	Template:Cd
woodland_mansions Template:Only	Template:EnvLink	20	80	10387319	Template:Cd

History

External links

• Structure set Generator on misode.github.io