手册:minecraft:scatter_feature

minecraft:scatter_feature

模式

所属域

features

类型

散植地物

加入版本

?

用于将地物散植到区块当中。

语法

"minecraft:scatter_feature": {
  "description": {
    "identifier": "<par1>"
  },
  "places_feature": "<par2>",
  "project_input_to_floor": <par3>
  "iterations": <par4>,
  "scatter_chance": <par5>,
  "x": <par6>,
  "y": <par7>,
  "z": <par8>,
  "coordinate_eval_order": "<par9>"
}

结构

•  minecraft:scatter_feature：根对象。
  •  description：描述。
    •  identifier：设置此地物的赋命名空间标识符。
  •  places_feature：设置要散植的地物，填写其赋命名空间标识符。
  •  project_input_to_floor：设置是否将地物投射到高度图中。
  •  iterations：设置地物的迭代次数（即地物尝试放置的次数）。
  •  scatter_chance：设置地物的散植成功机会。当填写数字时，游戏会将该数字当做百分数：

    "scatter_chance": 12.5
    

    使用Molang表达式时，游戏将以分数形式来读取：

    "scatter_chance": "1 / 8"
    

    对象形式的参数也可以表示分数：

    "scatter_chance": {
      "numerator": 1,
      "denominator": 8
    }
    

    以上三种形式的成功机会都是12.5%。
  •  x：设置放置时相对于地物原点的x轴坐标。可填数字、Molang或对象。当使用对象表示x轴坐标时，distribution参数为字符串，用于设置预设的分布类型；extent参数为数组，用于设置分布范围。例如：

    "x": {
      "distribution": "uniform",
      "extent": [ 0, 15 ]
    }
    

    
    
  •  y：设置放置时相对于地物原点的y轴坐标，语法结构与x相同。
  •  z：设置放置时相对于地物原点的z轴坐标，语法结构与x相同。
  •  coordinate_eval_order：设置坐标的判断顺序。默认值为xzy。

判断顺序

在散植地物放置目标地物时，它会首先根据scatter_chance设置的分散机会来判断此次放置是否成功。若失败，则停止后面的步骤，反之则进行下一步判断。

接下来它将判断设置的迭代次数，若迭代次数没有解析为正整数，则不会进行下一步的判断。

然后它将根据设置的迭代次数进行相应次数的迭代，无论每次迭代因何种原因失败，都不会影响下一次迭代。对于每次迭代，都会使用相同的顺序来计算其坐标。

分布类型

均匀分布

可将目标地物在指定的半开区间（左闭右开）范围内均匀放置，其字符串为uniform。

高斯分布

可将目标地物以高斯分布的形式放置在指定半开区间（左闭右开）范围内放置，其字符串为gaussian。

主条目：高斯分布

逆高斯分布

可将目标地物以逆高斯分布的形式放置在指定半开区间（左闭右开）范围内放置，其字符串为inverse_gaussian。

主条目：逆高斯分布

示例

下面的示例将以海平面的高度水平散植花到生物群系的半个区块中。

{
  "format_version": 1.13.0,
  "minecraft:scatter_feature": {
    "description": {
      "identifier": "example:scatter_flowers_feature"
    },
    "places_feature": "example:flower_feature",
    "iterations": 10,
    "scatter_chance": 50.0,
    "x": {
      "distribution": "uniform",
      "extent": [ 0, 15 ]
    },
    "y": 64,
    "z": {
      "distribution": "uniform",
      "extent": [ 0, 15 ]
    }
  }
}

历史

基岩版
?		?			加入了minecraft:scatter_feature。

漏洞

关于“minecraft:scatter_feature”的漏洞在国际版中由漏洞追踪器维护，请在此报告漏洞。