Carver definition

This feature is exclusive to Java Edition.
 

Configured carvers are used to add caves and canyons. They are referenced in biomes.

Definition

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

JSON format

  • [NBT Compound / JSON Object]: The root object.
    • [String] type: The ID of carver type; see below.
    • [NBT Compound / JSON Object] config: Configuration values for the carver.
      • [Float] probability: The probability that each chunk attempts to generate carvers. Value between 0 and 1 (both inclusive).
      • [NBT Compound / JSON Object] y: The height at which this carver attempts to generate.
        • Height provider see Template:Nbt inherit/height provider/template
      • [NBT Compound / JSON Object] lava_level: The Y-level below or equal to which the carved areas are filled with lava. Doesn't affect nether_cave (where lava level is always bottom_y + 31). Note that the carver is also filled with the fluid from aquifers, which always include lava below -54.
        • Choices for a vertical anchor (must choose only one of the three) see Template:Nbt inherit/vertical anchor/template
      • [String][NBT List / JSON Array] replaceable: Blocks that can be carved. Can be a block ID, a block tag, or a list of block IDs.
      • [NBT Compound / JSON Object] debug_settings: (optional) Replaces blocks in the carved areas for debugging.
        • [Boolean] debug_mode: (optional, defauts to false) Enable debug mode for this carver.
        • [NBT Compound / JSON Object] air_state: (optional, defaults to acacia button's default state) Replaces air blocks.
          • Block state see Template:Nbt inherit/block state/template
        • [NBT Compound / JSON Object] water_state: (optional, defaults to acacia button's default state) Replaces water blocks and then waterlogs these blocks.
          • Block state see Template:Nbt inherit/block state/template
        • [NBT Compound / JSON Object] lava_state: (optional, defaults to acacia button's default state) Replaces lava blocks.
          • Block state see Template:Nbt inherit/block state/template
        • [NBT Compound / JSON Object] barrier_state: (optional, defaults to acacia button's default state) Replaces barriers of aquifers.
          • Block state see Template:Nbt inherit/block state/template
      • Additional fields based on [String] type; see below.

Carver Type

The carver type determines the shape of the carving.

cave and nether_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 are similar to caves, but with a less frequency and wider tunnels . Also, aquifer doesn't work: The carved blocks below bottom_y + 32.0 are filled with lava.

Additional fields:

    • [Float][NBT Compound / JSON Object] yScale: Vertically scales circular voids.
      • Float provider see Template:Nbt inherit/float_provider/template
    • [Float][NBT Compound / JSON Object] horizontal_radius_multiplier: Horizonally scales cave tunnels. Doesn't affect the length of tunnels.
      • Float provider see Template:Nbt inherit/float_provider/template
    • [Float][NBT Compound / JSON Object] vertical_radius_multiplier: Vertically scales cave tunnels. Doesn't affect the length of tunnels.
      • Float provider see Template:Nbt inherit/float_provider/template
    • [Float][NBT Compound / JSON Object] 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.
        • Float provider see Template:Nbt inherit/float_provider/template

canyon

Carves a canyon.

Additional fields:

    • [Float][NBT Compound / JSON Object] yScale: Vertically scales canyons.
      • Float provider see Template:Nbt inherit/float_provider/template
    • [Float][NBT Compound / JSON Object] vertical_rotation: Vertical rotation as a canyon extends.
      • Float provider see Template:Nbt inherit/float_provider/template
    • [NBT Compound / JSON Object] shape: The shape to use for the ravine.
      • [Float][NBT Compound / JSON Object] distance_factor: Scales the length of canyons. Higher values make canyons longer.
        • Float provider see Template:Nbt inherit/float_provider/template
      • [Float][NBT Compound / JSON Object] thickness: Scales the breadth and height of canyons.
        • Float provider see Template:Nbt inherit/float_provider/template
      • [Float][NBT Compound / JSON Object] horizontal_radius_factor: Scales the breadth of canyons. Higher values make canyons wider.
        • Float provider see Template:Nbt inherit/float_provider/template
      • [Float] vertical_radius_default_factor: Vertically scales canyons. Higher values make canyons deeper.
      • [Float] vertical_radius_center_factor: Scales the height based on the horizontal distance from the canyon's center, resulting in deeper center.
      • [Int] width_smoothness: Higher values smooth canyon walls on the vertical axis. Must be greater than 0.

History

Java Edition
1.16.220w28aAdded experimental support for configured carvers in data packs.
1.1721w06aRemoved carvers underwater_canyon and underwater_cave.
21w08aAdded configuration for the canyon carver.
Added optional carver field debug_settings. When enabled with debug_mode, can place blocks from air_state.
21w11aRenamed canyon carver field distanceFactor to distance_factor.
21w13aAdded configuration for the cave carver.
Replaced carver field bottom_inclusive and top_inclusive with field y, which is a height provider. Added field yScale.
Moved canyon carver shape fields into sub-object shape.
21w16aAdded field aquifers_enabled.
Added fields water_state, lava_state, and barrier_state in the debug_settings object.
1.1821w38aRemoved field aquifers_enabled.
1.1922w15aAdded field replaceable to carver configuration.

External links

Navigation

  • v
  • t
  • e
Java Edition technical
Data pack
Components
Tag
GameTest
World generation
Noise settings
Structures
Data packs
Tutorials
Content
World generation
This article is issued from Minecraft Wiki. The text is available under CC BY-NC-SA 3.0 unless otherwise noted. Additional terms may apply for the media files.