Datapack Codex

Structure set/JSON format

Minecraft Wiki article. Categories: Java_Edition, Data_packs

📌 Mirrored from Minecraft Wiki

This article is reproduced from Structure set/JSON format on the Minecraft Wiki. Mirrored from revision 3700162. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

  • [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, due to MC-307874 removes lines of structure attempts in Z cardinal direction), 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, not affected by MC-307874) 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.

Sources