Carver Configuration - PolyhedralDev/Terra Wiki

Original URL:

Carver configurations are in the carving/ directory within a config pack.
Carvers "carve" out sections of a world after generation. They are typically used to create caves and ravines.
A carver is essentially an ellipse. This ellipse then moves around the world on a randomly determined path (called a worm), carving out where it moves.

Object Options

Carvers support all Terra Object Options.



The minimum and maximum length of the cave.


How many blocks the worm should move each step. Example: a value of 2 would cause the worm to move 2 blocks between each carving. Defaults to 2.


Configuration for how the carver begins.

Radius Equations

The X, Y, and Z radius equations are mathematical expressions to be evaluated at each carving step. 2 variables are provided to these expressions:


Options to "cut off" the topmost/bottommost parts of the carved area. This can be used to give your carvings flat floors/ceilings.


How to mutate the carver as it progresses.


A list of blocks to shift downwards when carved. List elements should be formatted as:

"minecraft:block_id": # ID of block to pull downwards.
  - "minecraft:other_block_1" # Block that can be replaced
  - "minecraft:other_block_2" # More blocks that can be replaced...

The most common use of this is definitely pulling Grass Blocks down into exposed dirt.

  "minecraft:grass_block": ["minecraft:dirt"]


A list of block IDs that should be updated during generation. **Do not include anything in this option unless you are pregenerating, as this option can be extremely laggy!) Example that prevents floating water in caves:

  - "minecraft:water"


Options for cave floor, wall, ceiling, and center palettes.

These are not standard palettes! Carver palettes must be defined in the carver file.

Cave Palette Configuration

Cave palettes hold more information than standard palettes, hence why they are kept separate. The config scheme outlined in this section is to be used in the palette keys in a Carver config.


A list of block IDs that may be replaced by this palette.


Whether the materials in replace should be treated as a whitelist or blacklist.


How many blocks to continue before recalculating the worm's direction.


Standard palette layer configuration (see Palette page)
One key difference: The layers sub-option has been replaced with y. while layers defines how many layers to continue the palette layer, y defines the Y-level under which the layer generates.

⚠️ ** Fallback** ⚠️