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 4: / Line 4: @@
 == Definition ==
 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}}
@@ 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}}: Vertically scales circular voids.
+**{{Nbt|float}}{{Nbt|compound|room_vertical_radius_multiplier}}: Vertically scales circular voids.
 **{{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}}
@@ 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}}