雕刻器数据格式

雕刻器（Carvers）用于雕刻出洞穴和峡谷。已配置的雕刻器以JSON文件的形式存储在数据包的data/<命名空间>/worldgen/configured_carver目录下。

雕刻器类型

雕刻器类型（或称为雕刻器）决定了该雕刻器雕刻要雕刻出什么。用三种雕刻器类型：

• cave - 雕刻一个洞穴，一个多岔道的长长隧道，有时从环形空腔开始。
• nether_cave - 类似于cave，但频率低而隧道宽，且无含水层，于bottom_y + 32.0填充熔岩。
• canyon - 雕刻一个峡谷。

已配置的雕刻器

雕刻器类型决定了要雕刻的对象，具体的细节需要额外配置。配置后被称为已配置的雕刻器，或简称为雕刻器。

已配置的雕刻器以JSON文件的形式存储在数据包的data/<命名空间>/worldgen/configured_carver目录下。

JSON格式

• 根节点
  • type：雕刻器类型ID。
  • config：雕刻器的配置。
    • probability：每个区块尝试生成此雕刻器的概率，取值为0到1的闭区间。
    • y：雕刻器尝试生成的高度。
      • 高度提供器，见自定义世界生成/height provider[显示]
    • lava_level：低于或等于此Y坐标的雕刻区域填充熔岩。不影响nether_cave（其该值永远为最低Y坐标 + 31）
      • 垂直锚点，见自定义世界生成/vertical anchor[显示]
    • replaceable：可以雕刻的方块。可以为一个方块ID或一个方块标签，或者是一个方块ID的列表。
    • debug_settings：（可选）为调试而替换雕刻区域内的方块。
      • debug_mode：（可选，默认为false）启用雕刻器的调试模式。
      • air_state：（可选，默认为金合欢木按钮的默认方块状态) 替换空气方块。
        • 方块状态，见自定义世界生成/block_state[显示]
      • water_state：（可选，默认为金合欢木按钮的默认方块状态) 替换水，且替换后方块含水。
        • 方块状态，见自定义世界生成/block_state[显示]
      • lava_state：（可选，默认为金合欢木按钮的默认方块状态) 替换熔岩。
        • 方块状态，见自定义世界生成/block_state[显示]
      • barrier_state：（可选，默认为金合欢木按钮的默认方块状态) 替换含水层的隔离方块。
        • 方块状态，见自定义世界生成/block_state[显示]

      若雕刻器类型为cave或nether_cave，附加参数如下：

    • yScale：垂直缩放洞穴的环形空腔。
      • 浮点提供器，见已配置的地物/float provider[显示]
    • horizontal_radius_multiplier：水平缩放洞穴的隧道。不影响隧道的长度。
      • 浮点提供器，见已配置的地物/float provider[显示]
    • vertical_radius_multiplier：垂直缩放洞穴的隧道。不影响隧道的长度。
      • 浮点提供器，见已配置的地物/float provider[显示]
    • floor_level：取值为-1.0到1.0的闭区间。改变洞穴水平地板的形状。如果为0.0，使用椭球体进行雕刻。若为1.0，使用上半椭球体进行雕刻，以得到水平的地面。
      • 浮点提供器，见已配置的地物/float provider[显示]

      若雕刻器类型为canyon，附加参数如下：

    • yScale：垂直缩放峡谷。
      • 浮点提供器，见已配置的地物/float provider[显示]
    • vertical_rotation：峡谷延伸垂直角度。
      • 浮点提供器，见已配置的地物/float provider[显示]
    • shape：峡谷形状。
      • distance_factor：缩放峡谷长度，值越大越长。
        • 浮点提供器，见已配置的地物/float provider[显示]
      • thickness：缩放峡谷长宽。
        • 浮点提供器，见已配置的地物/float provider[显示]
      • horizontal_radius_factor：缩放峡谷宽度，值越大越宽。
        • 浮点提供器，见已配置的地物/float provider[显示]
      • vertical_radius_default_factor：垂直缩放峡谷。值越大越深。
      • vertical_radius_center_factor：根据到峡谷中心的距离缩放高度，使峡谷中心更深，
      • width_smoothness：值越高，峡谷的墙壁在垂直方向上越平滑，必须为正整数。

历史

Java版
1.16.2			20w28a				为数据包中已配置的雕刻器加入了实验性支持。
			20w30a				将雕刻器类型字段name重命名为type。
			pre1				已配置的雕刻器从data/minecraft/worldgen/configured_carver/<命名空间>/<路径>移动到data/<命名空间>/worldgen/configured_carver/<路径>，和其他资源保持一致。
1.17			21w06a				移除了雕刻器类型underwater_canyon与underwater_cave。
			21w08a				为峡谷雕刻器canyon加入了配置字段。
							加入了debug_settings可选字段，若debug_mode为true，雕刻器会用air_state提供的方块替换本该填充空气的方块。
			21w11a				重命名峡谷雕刻器字段distanceFactor为distance_factor。
			21w13a				移除了峡谷雕刻器的y_scale字段。
							将峡谷雕刻器形状字段移动至shape子对象中。
							为洞穴雕刻器cave和​nether_cave加入了配置字段。
							加入了yScale字段和lava_level垂直锚点字段。
							将bottom_inclusive和​top_inclusive字段替换为y高度提供器字段，此前为两个垂直锚点字段。
			21w15a				重新加入了雕刻器类型underwater_canyon和​underwater_cave，配置字段格式与canyon和​cave相同。
			21w16a				加入了aquifers_enabled字段。
							向debug_settings字段加入了water_state、​lava_state和​barrier_state字段，格式与air_state一致。
1.18			21w37a				现在Y<-54的区域总是填充熔岩，无视lava_level字段。
			21w38a				移除了aquifers_enabled字段。
			21w39a				再次移除了雕刻器类型underwater_canyon和​underwater_cave，此前这两种雕刻器默认填充水，Y=10填充黑曜石和岩浆块，Y<10填充熔岩。
1.19			22w15a				加入了replaceable字段。
1.20.5			24w13a				整数提供器和浮点提供器参数的值不再包装在type旁额外的value字段。