Structure set

JSON format

• [NBT Compound / JSON Object]: Root object.
  • [NBT List / JSON Array] structures: (Required, but can be empty) The structures that may be placed. One configured structure feature shouldn't be included by two structure sets.
    • [NBT Compound / JSON Object]: A structure to be placed.
      • [String][NBT Compound / JSON Object] structure: One structure (an [String] ID) — The structure to be placed.
      • [Int] weight: Determines the chance of it being chosen over others. Must be a positive integer.
  • [NBT Compound / JSON Object] placement: How the structures should be placed.
    • [Int] salt: A number that assists in randomization; see salt (cryptography). Must be a non-negative integer.
    • [Float] frequency: (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.
    • [String] frequency_reduction_method: (Optional, defaults to default) Provides a random number generator algorithm for frequency. One of default (the random number depends on the seed, position and [Int] salt), legacy_type_1 (the random number depends only on the seed and position, and randomness only occurs when the locations differ greatly), legacy_type_2 (same as default, but with fixed salt: 10387320) and legacy_type_3 (the random number depends only on seed and position).
    • [NBT Compound / JSON Object] exclusion_zone: Specifies that it cannot be placed near certain structures.
      • [Int] chunk_count: Value between 1 and 16 (inclusive).
      • [String] other_set: A structure set ID.
    • [NBT List / JSON Array] locate_offset: (optional, defaults to [0,0,0]) The chunk coordinate offset given when using /locate structure.
      • [Int]: X. Value between -16 and 16 (inclusive).
      • [Int]: Y. Value between -16 and 16 (inclusive).
      • [Int]: Z. Value between -16 and 16 (inclusive).
    • [String] type: One of minecraft:concentric_rings or minecraft:random_spread.
    • Additional fields depending on value of [String] type, see Placement types.

Bedrock Edition:

• [NBT Compound / JSON Object] Structure Set
  • [String] format_version: The version of the game to run this file as. Can be a version above 1.21.20.
  • [NBT Compound / JSON Object] minecraft:structure_set:
    • [NBT Compound / JSON Object] description
      • [String] identifier: The identifier used for the structure set.
    • [NBT Compound / JSON Object] placement: How the structures should be placed.
      • [String] type: The type of spread. Can be minecraft:random_spread.
      • [Float] salt: A random 8 number sequence used for randomizing placement similarly to a world seed.
      • [Float] spacing: Size in chunks of the grid space used to place the structure
      • [Float] separation: Padding between placements of set placements.
      • [String] spread_type: Algorithm used when placing structures. Can be linear or triangular.
    • [NBT List / JSON Array] structures: Weighted list of structures that can be placed.
      • [NBT Compound / JSON Object]: A structure to be placed.
        • [String] structure: A structure identifier.
        • [Float] weight: Determines the chance of it being chosen over others. Must be a positive integer.

Placement types

random_spread

• additional fields:
  • [String] spread_type: (optional, defaults to linear) One of linear or triangular. linear sets offset to a random value between 0 and spacing - separation - 1 (inclusive). triangular takes the sum of 2 random numbers between 0 and spacing - separation - 1 (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.
  • [Int] spacing: Average distance between two neighboring generation attempts. Value between 0 and 4096 (inclusive).
  • [Int] separation: Minimum distance (in chunks) between two neighboring attempts. Value between 0 and 4096 (inclusive). Has to be strictly smaller than [Int] spacing. The maximum distance of two neighboring generation attempts is 2*spacing - separation.

concentric_rings

• additional fields:
  • [Int] distance: 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
  • [Int] count: The total number of generation attempts in this dimension. Value between 1 and 4095 (inclusive).
  • [String][NBT List / JSON Array] preferred_biomes: Any number of biome(s) (an [String] ID, or a [String] tag with #, or an [NBT List / JSON Array] array containing [String] IDs) — 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 [String][NBT List / JSON Array] preferred_biomes 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.
  • [Int] spread: 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: spread * (N^2 + 3 * N + 2) / 6, until the number of attempts reaches the total [Int] count.

Default structure sets

External links

Navigation