# config.yml

## Terrain Settings

```yaml
terrain:
  base_height: 67
  bedrock_layers: 5
```

* **base\_height** - Center height for terrain generation (default: 67)
* **bedrock\_layers** - Bedrock layers at world bottom (default: 5)

### Advanced Terrain

```yaml
terrain:
  advanced:
    max_variation: 18
    noise_multiplier: 0.9
    amplitude_multiplier: 1.8
```

* **max\_variation** - Height variation from base (default: 18 blocks)
* **noise\_multiplier** - Terrain change intensity (0.1-2.0, default: 0.9)
* **amplitude\_multiplier** - Height amplitude (0.5-3.0, default: 1.8)

## Vegetation Settings

### Global Vegetation

```yaml
vegetation:
  global:
    trees_enabled: true
    flowers_enabled: true
    grass:
      enabled: true
      tall_grass_enabled: true
      density: 1.0
```

* **trees\_enabled** - Enable/disable all trees
* **flowers\_enabled** - Enable/disable all flowers
* **grass.density** - Grass amount (0.0-2.0, default: 1.0)

### Biome-Specific Vegetation

Each biome has its own vegetation settings. Example for Plains:

```yaml
generators:
  plains:
    vegetation:
      tree_enabled: true
      tree_chance: 0.001
      tall_grass_enabled: true
      tall_grass_chance: 0.005
```

{% hint style="info" %}
Chance values:

* 0.0 = never
* 0.001 = rare
* 0.01 = common
* 0.1 = very common
  {% endhint %}

## Biome Generator Settings

### Desert

```yaml
generators:
  desert:
    enabled: true
    sand_depth:
      min: 2
      max: 4
    sandstone_depth: 6
    vegetation:
      cactus_enabled: true
      cactus_chance: 0.002
      dead_bush_enabled: true
      dead_bush_chance: 0.002
```

### Plains

```yaml
generators:
  plains:
    enabled: true
    dirt_depth:
      min: 3
      max: 6
```

### Snowy Plains

```yaml
generators:
  snowyplains:
    enabled: true
    dirt_depth:
      min: 3
      max: 6
    snow:
      enabled: true
      thickness: 1
    vegetation:
      tree_enabled: true
      tree_chance: 0.001
      pumpkin_patch_enabled: true
      pumpkin_patch_chance: 0.0008
```

* **snow\.thickness** - Snow layer height (1-8, where 8 = full block)

### Badlands

```yaml
generators:
  badlands:
    enabled: true
    terracotta_depth: 10
    vegetation:
      cactus_chance: 0.008
      dead_bush_chance: 0.005
```

### Mushroom Fields

```yaml
generators:
  mushroom:
    enabled: true
    dirt_depth:
      min: 3
      max: 6
    vegetation:
      giant_mushroom_enabled: true
      giant_mushroom_chance: 0.0005
      red_mushroom_enabled: true
      red_mushroom_chance: 0.002
      brown_mushroom_enabled: true
      brown_mushroom_chance: 0.002
```

### End

```yaml
generators:
  end:
    enabled: true
    platform_height: 64
    layer_thickness: 1
    mobs:
      endermen_enabled: true
      ender_dragon_enabled: true
    vegetation:
      chorus_plant_enabled: true
      chorus_plant_chance: 0.001
```

## Gameplay Settings

```yaml
gameplay:
  mobs_enabled: true
```

* **mobs\_enabled** - Enable/disable mob spawning (default: true)

Apply mob settings to existing worlds with: `/bg applysettings`

## Performance Settings

```yaml
performance:
  chunk_preloading: false
  preload:
    chunks_per_tick: 4
  memory:
    cache_noise_generators: true
    cache_size: 100
```

* **chunk\_preloading** - Enable chunk preloading (default: false)
* **chunks\_per\_tick** - Chunks to preload per tick (1-10, default: 4)
* **cache\_noise\_generators** - Cache generators for performance (default: true)
* **cache\_size** - Number of generators to cache (default: 100)

## Debug Settings

```yaml
debug:
  verbose_logging: false
  performance_monitoring: false
  log_terrain_stats: false
```

Enable verbose logging with: `/bg debug`

## World-Specific Settings

Override global settings for specific worlds:

```yaml
worlds:
  "myworld":
    terrain:
      base_height: 80
      advanced:
        max_variation: 25
    generators:
      plains:
        vegetation:
          tree_chance: 0.01
```

Any setting can be overridden per world. Settings not specified use global defaults.

{% hint style="info" %}
Tips

* Reload config without restarting: `/bg reload`
* View current settings: `/bg info`
* Lower vegetation chances = more sparse, higher = more dense
* Increase `max_variation` for dramatic terrain
* Disable specific features by setting `enabled: false`
  {% endhint %}
