Minecraft:Carver definition: Difference between revisions

Latest revision as of 11:11, 17 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

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
  - Additional fields based on Template:Nbt; see below.

Carver Type

The carver type determines the shape of the carving.

Template:Cd

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

Additional fields:

- Template:Nbt 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: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 5: / Line 5: @@
 Configured carvers can be defined in [[Minecraft:data pack]]s, as part of the directory structure below.
-{{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}}
-{{Data pack directory|carver|<nowiki><name>.json</nowiki>|worldgen=1}}{{upcoming|JE 26.3}}
 == JSON format ==
@@ Line 17: / Line 15: @@
 ***{{Nbt|compound|y}}: The height at which this carver attempts to generate.
 **** {{nbt inherit/height_provider}}
-***{{Nbt|compound|lava_level}}{{until|JE 26.3}}: The Y-level below or equal to which the carved areas are filled with lava. Doesn't affect {{cd|nether_cave}} (where lava level is always {{cd|bottom_y + 31}}). Note that the carver is also filled with the fluid from [[Minecraft:aquifers]], which always include lava below {{cd|-54}}.
-**** {{nbt inherit/vertical_anchor}}
-***{{Nbt|string}}{{Nbt|list|replaceable}}{{until|JE 26.3}}: Blocks that can be carved. Can be a block ID, a block tag, or a list of block IDs.
-***{{Nbt|compound|debug_settings}}{{until|JE 26.3}}: (optional) Replaces blocks in the carved areas for debugging.
-****{{Nbt|bool|debug_mode}}: (optional, defauts to false) Enable debug mode for this carver.
-****{{Nbt|compound|air_state}}: (optional, defaults to acacia button's default state) Replaces air blocks.
-***** {{Nbt inherit/block state}}
-****{{Nbt|compound|water_state}}: (optional, defaults to acacia button's default state) Replaces water blocks and then waterlogs these blocks.
-***** {{Nbt inherit/block state}}
-****{{Nbt|compound|lava_state}}: (optional, defaults to acacia button's default state) Replaces lava blocks.
-***** {{Nbt inherit/block state}}
-****{{Nbt|compound|barrier_state}}: (optional, defaults to acacia button's default state) Replaces barriers of aquifers.
-***** {{Nbt inherit/block state}}
 *** Additional fields based on {{Nbt|string|type}}; see below.</div>
@@ Line 35: / Line 20: @@
 The '''carver type''' determines the shape of the carving.
-=== {{cd|cave}} and {{cd|nether_cave}} ===
+=== {{cd|cave}} ===
 Carves a cave. A cave is a long tunnel that sometimes branches. Sometimes one or more tunnels start from a circular void.
-Nether caves{{until|JE 26.3}} are similar to caves, but with a less frequency and wider tunnels {{verify|is this not just a difference in configuration?}}. Also, [[Minecraft:aquifer]] doesn't work: The carved blocks below {{cd|bottom_y + 32.0}} are filled with lava.
 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|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 60: / Line 43: @@
 Additional fields:
 <div class="treeview">
-**{{Nbt|float}}{{Nbt|compound|yScale}}{{until|JE 26.3}}: Vertically scales canyons.
-*** {{nbt inherit/float_provider}}
 **{{Nbt|float}}{{Nbt|compound|vertical_rotation}}: Vertical rotation as a canyon extends.
 *** {{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 72: @@
 |{{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: