Carver Configuration - PolyhedralDev/Terra Wiki

Original URL: https://github.com/PolyhedralDev/Terra/wiki/Carver-Configuration

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.

Options

length

The minimum and maximum length of the cave.

step

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.

start

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:

cut

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

mutate

How to mutate the carver as it progresses.

shift

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.

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

update

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:

update:
  - "minecraft:water"

palette

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.

replace

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

replace-blacklist

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

recalculate-direction

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

layers

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.

⚠️ **GitHub.com Fallback** ⚠️