Configured carvers are used to add caves and canyons. They are referenced in biomes.
Configured carvers can be defined in data packs, as part of the directory structure below.
- [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.
- [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.
- [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.
- [NBT Compound / JSON Object] water_state: (optional, defaults to acacia button's default state) Replaces water blocks and then waterlogs these blocks.
- [NBT Compound / JSON Object] lava_state: (optional, defaults to acacia button's default state) Replaces lava blocks.
- [NBT Compound / JSON Object] barrier_state: (optional, defaults to acacia button's default state) Replaces barriers of aquifers.
- Additional fields based on [String] type; see below.
The carver type determines the shape of the carving.
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 [verify]. 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][NBT Compound / JSON Object] horizontal_radius_multiplier: Horizonally scales cave tunnels. Doesn't affect the length of tunnels.
- [Float][NBT Compound / JSON Object] vertical_radius_multiplier: Vertically scales cave tunnels. Doesn't affect the length of tunnels.
- [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.
Carves a canyon.
Additional fields:
- [Float][NBT Compound / JSON Object] yScale: Vertically scales canyons.
- [Float][NBT Compound / JSON Object] vertical_rotation: Vertical rotation as a canyon extends.
- [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][NBT Compound / JSON Object] thickness: Scales the breadth and height of canyons.
- [Float][NBT Compound / JSON Object] horizontal_radius_factor: Scales the breadth of canyons. Higher values make canyons wider.
- [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.
| Java Edition |
|---|
| 1.16.2 | 20w28a | Added experimental support for configured carvers in data packs. |
|---|
| 1.17 | 21w06a | Removed carvers underwater_canyon and underwater_cave. |
|---|
| 21w08a | Added configuration for the canyon carver.
|
|---|
Added optional carver field debug_settings. When enabled with debug_mode, can place blocks from air_state. |
| 21w11a | Renamed canyon carver field distanceFactor to distance_factor. |
|---|
| 21w13a | Added 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. |
| 21w16a | Added field aquifers_enabled.
|
|---|
Added fields water_state, lava_state, and barrier_state in the debug_settings object. |
| 1.18 | 21w38a | Removed field aquifers_enabled. |
|---|
| 1.19 | 22w15a | Added field replaceable to carver configuration. |
|---|