Minecraft:Carver definition: Difference between revisions

Latest revision as of 11:04, 13 July 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 Template:Upcoming

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 Template:Upcoming: Vertically scales circular voids.
- Template:NbtTemplate:NbtTemplate:Upcoming: 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:NbtTemplate:Upcoming: 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 Template:Upcoming: Multiplier for the radius of carved tunnels.
- Template:NbtTemplate:NbtTemplate:Upcoming: 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 Template:Upcoming: 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 43: / Line 43: @@
 <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|int}}{{nbt|compount|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}}{{upcoming|JE 26.3}}: 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.
@@ Line 60: / Line 60: @@
 Additional fields:
 <div class="treeview">
-**{{Nbt|float}}{{Nbt|compound|yScale}}{{until|JE 26.3}} Vertically scales canyons.
+**{{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}}{{upcoming|JE 26.3}}: Vertically scales canyons.
 ***{{Nbt|float}}{{Nbt|compound|distance_factor}}: Scales the length of canyons. Higher values make canyons longer.
 **** {{nbt inherit/float_provider}}