Terrain Customization

Advanced techniques for customizing terrain generation.

Noise Generation Parameters

BiomeGen uses multi-layered Perlin noise for natural-looking terrain variation.

terrain:
  advanced:
    noise_settings:
      primary_frequency: 0.0025
      secondary_frequency: 0.005
      tertiary_frequency: 0.01
      valley_frequency: 0.002
      amplitude_blocks: 18.0
      hills_influence: 0.6
      valley_influence: 0.25

Frequency Settings

  • Lower frequency (0.001-0.002) = Gradual, rolling terrain

  • Higher frequency (0.01-0.02) = Sharp, varied terrain

  • primary_frequency - Main terrain features

  • secondary_frequency - Medium detail

  • tertiary_frequency - Fine detail

  • valley_frequency - Valley formation

Influence Settings

  • hills_influence (0.0-1.0) - Weight of hill generation

  • valley_influence (0.0-1.0) - Weight of valley generation

Balance these for different terrain styles.

Amplitude

  • amplitude_blocks - Maximum height change in blocks

  • Higher values = more dramatic terrain

  • Must match max_variation for consistency

Height Variation

Control terrain height range:

terrain:
  base_height: 67
  advanced:
    max_variation: 18

This creates terrain from 49 to 85 blocks (67 ± 18).

Examples:

  • Flatter terrain: max_variation: 10 (57-77 blocks)

  • Dramatic terrain: max_variation: 30 (37-97 blocks)

  • Nearly flat: max_variation: 3 (64-70 blocks)

World-Specific Overrides

Apply different settings to each world:

worlds:
  "flatworld":
    terrain:
      advanced:
        max_variation: 5
        noise_multiplier: 0.5

  "mountainworld":
    terrain:
      base_height: 80
      advanced:
        max_variation: 35
        amplitude_multiplier: 2.5
        noise_settings:
          primary_frequency: 0.002
          hills_influence: 0.8

Terrain Styles

Rolling Hills

terrain:
  advanced:
    max_variation: 15
    noise_multiplier: 0.7
    noise_settings:
      primary_frequency: 0.003
      hills_influence: 0.7
      valley_influence: 0.2

Dramatic Mountains

terrain:
  base_height: 85
  advanced:
    max_variation: 40
    amplitude_multiplier: 2.2
    noise_settings:
      primary_frequency: 0.002
      hills_influence: 0.8
      valley_influence: 0.1

Nearly Flat

terrain:
  advanced:
    max_variation: 4
    noise_multiplier: 0.3
    amplitude_multiplier: 0.8

Performance Considerations

Optimization tips:

  • Enable cache_noise_generators: true

  • Increase cache_size for better performance

  • Pre-generate chunks: /bg preload <world> <radius>

  • Use lower chunks_per_tick on busy servers

Testing Changes

1

Modify config values

Edit the relevant YAML configuration with your desired values.

2

Reload

Reload the plugin: /bg reload

3

Create test world or generate new chunks

Spawn a new world or generate chunks to see the new terrain applied.

4

View settings

Check current settings: /bg info

Note: Existing chunks are not affected by config changes. Only newly generated chunks use new settings.

Last updated