# hbmspace:cave

Caves with lava below a level.

Vanilla-shaped caves through `replaceable` blocks: air above `lava_level` and `lava` at and below it. An ellipsoid whose shell holds water is skipped. A cut column that passed a `top` block gives the `filler` block it exposes the biome's surface material.

## Fields

| Field | Meaning and default | Range |
| - | - | - |
| `probability` | Chance that a source chunk starts the carver. | `[0, 1]` |
| `y` | Vanilla height provider for start heights. | |
| `yScale` | Vanilla float provider: vertical scale of rooms. | |
| `lava_level` | Vertical anchor at and below which cuts fill with the lava block. | |
| `replaceable` | Block ID, `#tag` or ID list: blocks the carver may cut. | |
| `debug_settings` (Optional) | Vanilla carver debug settings; unused. | |
| `horizontal_radius_multiplier` | Vanilla float provider. | |
| `vertical_radius_multiplier` | Vanilla float provider. | |
| `floor_level` | Vanilla float provider within `[-1, 1]`. | |
| `lava` | Fill at and below `lava_level`. | |
| `lava.Name` | Registered block ID. | |
| `lava.Properties` (Optional) | Block-state property names and string values. | |
| `top` | Block ID, `#tag` or ID list: surface blocks. | |
| `filler` | Block ID, `#tag` or ID list: blocks re-topped when exposed. | |

The top-level `type` selects this carver; `config` supplies the fields above.

## Example

Source path: `data/hbmspace/worldgen/configured_carver/mun/caves.json`

```json
{
  "type": "hbmspace:cave",
  "config": {
    "filler": "hbmspace:moon_rock",
    "floor_level": -0.7,
    "horizontal_radius_multiplier": 1.0,
    "lava": {
      "Name": "minecraft:lava",
      "Properties": {
        "level": "0"
      }
    },
    "lava_level": {
      "absolute": 1
    },
    "probability": 0.14285715,
    "replaceable": [
      "hbmspace:moon_rock",
      "hbm:moon_turf"
    ],
    "top": "hbm:moon_turf",
    "vertical_radius_multiplier": 1.0,
    "y": {
      "type": "minecraft:biased_to_bottom",
      "inner": 8,
      "max_inclusive": {
        "absolute": 127
      },
      "min_inclusive": {
        "absolute": 0
      }
    },
    "yScale": 0.5
  }
}
```