Minecraft:Carver definition: Difference between revisions

Revision as of 11:13, 16 September 2026

Template:Exclusive Configured carvers are used to add Minecraft:caves and Minecraft:canyons. They are referenced in biomes.

Definition

Configured carvers can be defined in Minecraft:data packs, as part of the directory structure below.

Template:Data pack directory Template:Until

Template:Data pack directory

JSON format

Template:Nbt: The root object.
- Template:Nbt: The ID of carver type; see below.
- Template:Nbt: Configuration values for the carver.
  - Template:Nbt: The probability that each chunk attempts to generate carvers. Value between 0 and 1 (both inclusive).
  - Template:Nbt: The height at which this carver attempts to generate.
    - Template:Nbt inherit/height provider
  - Template:NbtTemplate:Until: The Y-level below or equal to which the carved areas are filled with lava. Doesn't affect Template:Cd (where lava level is always Template:Cd). Note that the carver is also filled with the fluid from Minecraft:aquifers, which always include lava below Template:Cd.
    - Template:Nbt inherit/vertical anchor
  - Template:Nbt Template:Nbt Template:Until: Blocks that can be carved. Can be a block ID, a block tag, or a list of block IDs.
  - Template:NbtTemplate:Until: (optional) Replaces blocks in the carved areas for debugging.
    - Template:Nbt: (optional, defauts to false) Enable debug mode for this carver.
    - Template:Nbt: (optional, defaults to acacia button's default state) Replaces air blocks.
      - Template:Nbt inherit/block state
    - Template:Nbt: (optional, defaults to acacia button's default state) Replaces water blocks and then waterlogs these blocks.
      - Template:Nbt inherit/block state
    - Template:Nbt: (optional, defaults to acacia button's default state) Replaces lava blocks.
      - Template:Nbt inherit/block state
    - Template:Nbt: (optional, defaults to acacia button's default state) Replaces barriers of aquifers.
      - Template:Nbt inherit/block state
  - Additional fields based on Template:Nbt; see below.

Carver Type

The carver type determines the shape of the carving.

Template:Cd and Template:Cd

Carves a cave. A cave is a long tunnel that sometimes branches. Sometimes one or more tunnels start from a circular void.

Nether cavesTemplate:Until are similar to caves, but with a less frequency and wider tunnels Template:Verify. Also, Minecraft:aquifer doesn't work: The carved blocks below Template:Cd are filled with lava.

Additional fields:

- Template:Nbt Template:Nbt Template:Until / Template:Nbt: Vertically scales circular voids.
- Template:NbtTemplate:Nbt: The number of cave tunnels to create from a seed chunk. The number must not be negative.
  - Template:Nbt inherit/float provider
- Template:NbtTemplate:Nbt: Horizonally scales cave tunnels. Doesn't affect the length of tunnels.
  - Template:Nbt inherit/float provider
- Template:Nbt Template:Nbt: Vertically scales cave tunnels. Doesn't affect the length of tunnels.
- Template:NbtTemplate:Nbt: Multiplier for the vertical radius of the first segment in each tunnel. If not specified, it defaults to 1.0.
  - Template:Nbt inherit/float provider
- Template:Nbt Template:Nbt: Value between -1.0 and 1.0 (both inclusive). Change the shape of the cave's horizontal floor. If 0.0, carves the terrain with ellipsoids. If 1.0, carves with upper semi-ellipsoids, resulting in a level floor.
- Template:Nbt Template:Nbt: Multiplier for the radius of carved tunnels.
- Template:NbtTemplate:Nbt: If Template:Cd, thickness will be multiplied with a 10% chance (e.g. Template:Cd). If not specified, it defaults to Template:Cd.
  - - Template:Nbt inherit/float provider

Template:Cd

Carves a canyon.

Additional fields:

- Template:NbtTemplate:NbtTemplate:Until: Vertically scales canyons.
  - Template:Nbt inherit/float provider
- Template:NbtTemplate:Nbt: Vertical rotation as a canyon extends.
  - Template:Nbt inherit/float provider
- Template:Nbt: The shape to use for the ravine.
  - Template:Nbt Template:Nbt: Vertically scales canyons.
  - Template:NbtTemplate:Nbt: Scales the length of canyons. Higher values make canyons longer.
    - Template:Nbt inherit/float provider
  - Template:NbtTemplate:Nbt: Scales the breadth and height of canyons.
    - Template:Nbt inherit/float provider
  - Template:NbtTemplate:Nbt: Scales the breadth of canyons. Higher values make canyons wider.
    - Template:Nbt inherit/float provider
  - Template:Nbt: Vertically scales canyons. Higher values make canyons deeper.
  - Template:Nbt: Scales the height based on the horizontal distance from the canyon's center, resulting in deeper center.
  - Template:Nbt: Higher values smooth canyon walls on the vertical axis. Must be greater than 0.

History

Template:HistoryTable

External links

Configured carver Generator on misode.github.io

Navigation

Template:Navbox Java Edition technical

Minecraft:de:Erosionsdefinition Minecraft:fr:Définition de sculpteur de terrain Minecraft:ja:洞窟開削機 Minecraft:pt:Definição de cavernas Minecraft:zh:雕刻器定义格式

@@ Line 7: / Line 7: @@
 {{Data pack directory|configured_carver|<nowiki><name>.json</nowiki>|worldgen=1}}{{until|JE 26.3}}
-{{Data pack directory|carver|<nowiki><name>.json</nowiki>|worldgen=1}}{{upcoming|JE 26.3}}
+{{Data pack directory|carver|<nowiki><name>.json</nowiki>|worldgen=1}}
 == JSON format ==
@@ Line 42: / Line 42: @@
 Additional fields:
 <div class="treeview">
-**{{Nbt|float}}{{Nbt|compound|yScale}}{{until|JE 26.3}} / {{Nbt|compound|room_vertical_radius_multiplier}}{{upcoming|JE 26.3}}: Vertically scales circular voids.
+**{{Nbt|float}}{{Nbt|compound|yScale}}{{until|JE 26.3}} / {{Nbt|compound|room_vertical_radius_multiplier}}: Vertically scales circular voids.
-**{{nbt|int}}{{nbt|compound|count}}{{upcoming|JE 26.3}}: The number of cave tunnels to create from a seed chunk. The number must not be negative.
+**{{nbt|int}}{{nbt|compound|count}}: The number of cave tunnels to create from a seed chunk. The number must not be negative.
 *** {{nbt inherit/float_provider}}
 **{{Nbt|float}}{{Nbt|compound|horizontal_radius_multiplier}}: Horizonally scales cave tunnels. Doesn't affect the length of tunnels.
 *** {{nbt inherit/float_provider}}
 **{{Nbt|float}}{{Nbt|compound|vertical_radius_multiplier}}: Vertically scales cave tunnels. Doesn't affect the length of tunnels.
-**{{nbt|float}}{{nbt|compound|start_vertical_radius_multiplier}}{{upcoming|JE 26.3}}: Multiplier for the vertical radius of the first segment in each tunnel. If not specified, it defaults to 1.0.
+**{{nbt|float}}{{nbt|compound|start_vertical_radius_multiplier}}: Multiplier for the vertical radius of the first segment in each tunnel. If not specified, it defaults to 1.0.
 *** {{nbt inherit/float_provider}}
 **{{Nbt|float}}{{Nbt|compound|floor_level}}: Value between -1.0 and 1.0 (both inclusive). Change the shape of the cave's horizontal floor. If 0.0, carves the terrain with ellipsoids. If 1.0, carves with upper semi-ellipsoids, resulting in a level floor.
-**{{Nbt|float}}{{Nbt|compound|thickness}}{{upcoming|JE 26.3}}: Multiplier for the radius of carved tunnels.
+**{{Nbt|float}}{{Nbt|compound|thickness}}: Multiplier for the radius of carved tunnels.
-**{{Nbt|boolean}}{{Nbt|compound|weird_thickness_bias}}{{upcoming|JE 26.3}}: If {{cd|true}}, thickness will be multiplied with a 10% chance (e.g. {{cd|random(0, 1) * random(0, 3) + 1}}). If not specified, it defaults to {{cd|false}}.
+**{{Nbt|boolean}}{{Nbt|compound|weird_thickness_bias}}: If {{cd|true}}, thickness will be multiplied with a 10% chance (e.g. {{cd|random(0, 1) * random(0, 3) + 1}}). If not specified, it defaults to {{cd|false}}.
 **** {{nbt inherit/float_provider}}</div>
@@ Line 65: / Line 65: @@
 *** {{nbt inherit/float_provider}}
 **{{Nbt|compound|shape}}: The shape to use for the ravine.
-*** {{Nbt|float}}{{Nbt|compound|y_scale}}{{upcoming|JE 26.3}}: Vertically scales canyons.
+*** {{Nbt|float}}{{Nbt|compound|y_scale}}: Vertically scales canyons.
 ***{{Nbt|float}}{{Nbt|compound|distance_factor}}: Scales the length of canyons. Higher values make canyons longer.
 **** {{nbt inherit/float_provider}}
@@ Line 91: / Line 91: @@
 |{{HistoryLine||1.18|dev=21w38a|Removed field {{cd|aquifers_enabled}}.}}
 |{{HistoryLine||1.19|dev=22w15a|Added field {{cd|replaceable}} to carver configuration.}}
-|{{HistoryLine|java upcoming}}
 |{{HistoryLine||26.3|dev=snap2|Removed carver {{cd|nether_cave}}.
 |Added cave carver fields: