Structure Sets
This content applies only to Java Edition.
Structure sets determine how structures generate during world generation. Definition files are their data-driven definitions in datapacks.
Definition format
Structure sets use the STRUCTURE_SET registry; the datapack path is worldgen/structure_set (definitions in data/<namespace>/worldgen/structure_set, tags in data/<namespace>/tags/worldgen/structure_set).
Definition files use JSON with the following structure:
- JSON file root object
structures (list, may be empty): placeable structure features.
structure (string/compound, required): a structure; inline definitions fail chunk saving (no namespace ID).weight (int, required): (≥1) selection weight.
placement (compound, required): placement behavior.
salt (int, required): random seed salt (non-negative).frequency (float, default 1.0): (0.0≤v≤1.0) attempt probability when other conditions hold.frequency_reduction_method (string, default default): default (world seed + coords + salt), legacy_type_1 (seed + coords only), legacy_type_2 (like default with fixed salt 10387320), legacy_type_3 (seed + coords only).exclusion_zone (compound): structures of this set cannot generate near another set; chunk_count (int, required, 1–16) + other_set (string, required).locate_offset (list, default [0,0,0]): /locate structure offset in chunks; each −16..16.type (string, required): placement type (below).
Placement types
concentric_rings (vanilla strongholds): fixed count per dimension in concentric rings around the world center.
distance (int, required): (0≤v≤1023) ring width + gap, in 6-chunk units.count (int, required): (1≤v≤4095) total attempts in the dimension.spread (int, required): (0≤v≤1023) attempts in the central ring.preferred_biomes (string/list, required): biomes the structure prefers.
random_spread (vanilla ocean monuments, swamp huts): the dimension is divided into spacing-chunk cells, each attempting once; structures generate only inside a separation-chunk inner area (extra strips never generate).
spread_type (string, default linear): linear or triangular (fewer extremes).spacing (int, required): (1≤v≤4096) average distance in chunks.separation (int, required): (0≤v<spacing) minimum distance; max distance = 2×spacing − separation.
dimension_origin (upcoming, Java 26.3): places at the dimension origin — for noise generators, preferably from spawn_target; otherwise chunk (0,0).
Definition behavior
Structure set data is loaded only once at server startup; /reload does not reload it — a server restart is required. During generation each dimension evaluates available sets; a structure is placed only if the probability, biome, and terrain checks pass, recording structure pieces to generate on chunk load.
1---2name: minecraft-structure-set3description: Minecraft Structure Set 结构集定义：STRUCTURE_SET 注册表、data/<namespace>/worldgen/structure_set/ 数据包路径、tags/worldgen/structure_set/ 标签、JSON 格式（structures 可放置结构特性列表 structure+weight、placement 放置行为 salt 随机种子盐 frequency 尝试概率 0-1 frequency_reduction_method 频率降低方法 default/legacy_type_1/legacy_type_2/legacy_type_3、exclusion_zone 排除区域 chunk_count+other_set、locate_offset /locate偏移 chunks -16..16、type 放置类型）、Placement Types 放置类型（concentric_rings 同心环 固定数量 环绕世界中心：distance 环宽度+间隙 6区块单位 0-1023、count 总尝试次数 1-4095、spread 中心环尝试次数 0-1023、preferred_biomes 首选生物群系；random_spread 随机扩散 分割维度为spacing区块单元格 每个尝试一次 结构仅在separation区块内生成：spread_type linear/triangular、spacing 平均距离 1-4096区块、separation 最小距离 0<spacing；dimension_origin 维度原点 26.3 放置在维度原点 噪声生成器首选spawn_target 否则区块(0,0)）、Definition Behavior 定义行为（服务器启动加载一次、/reload 不重新加载、生成期间每个维度评估可用集 结构仅在概率/生物群系/地形检查通过时放置）。4---56# Structure Sets78This content applies only to Java Edition.910Structure sets determine how structures generate during world generation. Definition files are their data-driven definitions in datapacks.1112## Definition format1314Structure sets use the `STRUCTURE_SET` registry; the datapack path is `worldgen/structure_set` (definitions in `data/<namespace>/worldgen/structure_set`, tags in `data/<namespace>/tags/worldgen/structure_set`).1516Definition files use JSON with the following structure:1718- JSON file root object19 - `structures` (list, may be empty): placeable structure features.20 - `structure` (string/compound, required): a structure; inline definitions fail chunk saving (no namespace ID).21 - `weight` (int, required): (≥1) selection weight.22 - `placement` (compound, required): placement behavior.23 - `salt` (int, required): random seed salt (non-negative).24 - `frequency` (float, default 1.0): (0.0≤v≤1.0) attempt probability when other conditions hold.25 - `frequency_reduction_method` (string, default `default`): `default` (world seed + coords + salt), `legacy_type_1` (seed + coords only), `legacy_type_2` (like default with fixed salt 10387320), `legacy_type_3` (seed + coords only).26 - `exclusion_zone` (compound): structures of this set cannot generate near another set; `chunk_count` (int, required, 1–16) + `other_set` (string, required).27 - `locate_offset` (list, default [0,0,0]): `/locate structure` offset in chunks; each −16..16.28 - `type` (string, required): placement type (below).2930### Placement types3132- `concentric_rings` (vanilla strongholds): fixed count per dimension in concentric rings around the world center.33 - `distance` (int, required): (0≤v≤1023) ring width + gap, in 6-chunk units.34 - `count` (int, required): (1≤v≤4095) total attempts in the dimension.35 - `spread` (int, required): (0≤v≤1023) attempts in the central ring.36 - `preferred_biomes` (string/list, required): biomes the structure prefers.37- `random_spread` (vanilla ocean monuments, swamp huts): the dimension is divided into `spacing`-chunk cells, each attempting once; structures generate only inside a `separation`-chunk inner area (extra strips never generate).38 - `spread_type` (string, default `linear`): `linear` or `triangular` (fewer extremes).39 - `spacing` (int, required): (1≤v≤4096) average distance in chunks.40 - `separation` (int, required): (0≤v<spacing) minimum distance; max distance = 2×spacing − separation.41- `dimension_origin` (upcoming, Java 26.3): places at the dimension origin — for noise generators, preferably from `spawn_target`; otherwise chunk (0,0).4243## Definition behavior4445Structure set data is loaded only once at server startup; `/reload` does not reload it — a server restart is required. During generation each dimension evaluates available sets; a structure is placed only if the probability, biome, and terrain checks pass, recording structure pieces to generate on chunk load.
ZMJJKK123-hub