Skip to content

1.12.2 Configuration Guide

Nick Young edited this page May 16, 2020 · 19 revisions

Table of Contents

Main Settings

The following is an elaboration on some of the settings that may be a little harder to understand.
If the setting you're looking for isn't here, try reading the comments for it in your config file (or in the example config at the bottom of this page).

Spawn Chance & Priority System

Priority System

Starting in v2.0, caves and caverns now operate using a "priority" system.

The priority systems for caves and caverns are distinct from eachother (although identical in functionality). Let's look only at caves for now.

Each type of cave - Type 1, Type 2, and Vanilla - has a Priority config option. This value (which must be 0 to 10, inclusive) determines how frequently caves of each type will spawn.

Here's how it works:

The chance of a cave type spawning in a given region depends on its priority relative to the other cave type priorities.
In mathematical terms, the formula is chance of cave type X spawning in region = (cave X priority) / (total cave priority)

Let's look through some examples.

Example:
Type 1 Cave Priority = 10
Type 2 Cave Priority = 5
Vanilla Cave Priority = 0

Chance of type 1 cave spawning = 10 / (10 + 5 + 0) = 10 / 15 = .67 or 67%
Chance of type 2 cave spawning = 5 / (10 + 5 + 0) = 5 / 15 = .33 or 33%
Chance of vanilla cave spawning = 0 / (10 + 5 + 0) = 0 or 0%

Example:
Type 1 Cave Priority = 1
Type 2 Cave Priority = 1
Vanilla Cave Priority = 1

Chance of type 1 cave spawning = 1 / (1 + 1 + 1) = 1 / 3 = .3 or 33%
Chance of type 2 cave spawning = 1 / (1 + 1 + 1) = 1 / 3 = .3 or 33%
Chance of vanilla cave spawning = 1 / (1 + 1 + 1) = 1 / 3 = .3 or 33%

Example:
Type 1 Cave Priority = 0
Type 2 Cave Priority = 0
Vanilla Cave Priority = 0

In this example, none of the 3 main cave types will spawn.
However, note that surface caves spawn independently of other caves, and will spawn as long as enabled.

As you can see from the examples, what matters are the relative priorities, NOT the absolute priorities.


Spawn Chance

The new options for spawn chance are very straightforward.

For cave and cavern generation, Better Caves splits the world up into regions (the sizes of which are controllable via the Region Size settings). The chance of a given region being inhabited by caves is given by the Cave Spawn Chance, and the same applies to caverns with the Cavern Spawn Chance. This value is a simple percent out of 100.

So, how does this interact with the priority system? Simple.

The priority system only operates on regions designated for caves/caverns.

Example:
Let's look at caverns for this example.

Say you have the following settings:
Liquid Cavern Priority = 10
Floored Cavern Priority = 5
Cavern Spawn Chance = 25

Then, Liquid Caverns and Floored Caverns have a 67% and 33% chance of spawning, respectively.
However, this proportion applies only on regions designated for caverns.

Thus,
.25 * .67 = .1675 or 16.75% of cavern regions will be Liquid Caverns, and
.25 * .33 = .0825 or 8.25% of cavern regions will be Floored Caverns.

Dimension-Specific Configurability

As of v2.0, Better Caves supports the ability to use different configuration settings for each dimension. To do this, create a directory called bettercaves-1_12_2 in your minecraft config directory. In this directory, you can create a separate config file for each dimension. Config files in this directory must be named with the following format: DIM#_config.cfg, where # is the dimension ID. For example, to add a separate config for the Nether, the file must be named DIM-1_config.cfg since the dimension ID of the Nether is -1.

The contents of each dimension's config file follow the exact same format as an ordinary config file for Forge 1.12.2. This means that you could copy the base config file bettercaves-1_12_2.cfg, rename it to DIM-1_config.cfg (for the Nether), and change the values to make it work for the Nether.

However, there are some important points to note. First, you do not need the comments (in neither the base config file nor any dimension-specific file), which are lines starting with #. They don't do anything except provide information. Second, the config file for a single dimension doesn't need to have every value specified. Any values not specified will be pulled from the base config. This is especially convenient, as it means you only need to specify the values you want to override.

For example, say you want a basic config for the Nether. This means you'll probably want to do the following:

  • Disable water regions
  • Enable Override Surface Detection
  • Change the Liquid Altitude to 31
  • Change caves to have a max altitude of 128
  • Change caverns to have a min altitude of 21 and max altitude of 55 (for example)
  • Disable surface caves, as they are not needed

The following file accomplishes all of this, and is a valid Better Caves single-dimension config file.
Remember, any options not specified here will be inherited from your base config file. So if you've got some weird options set there, they will show up in the Nether if you don't override them too!

# DIM-1_config.cfg
general {
    "underground generation" {
        caves {
            "surface caves" {
                B:"Enable Surface Caves"=false
            }
            "type 1 caves" {
                I:"Type 1 Cave Maximum Altitude"=128
            }
            "type 2 caves" {
                I:"Type 2 Cave Maximum Altitude"=128
            }
        }
        caverns {
            "liquid caverns" {
                I:"Liquid Cavern Maximum Altitude"=55
                I:"Liquid Cavern Minimum Altitude"=21
            }
            "floored caverns" {
                I:"Floored Cavern Maximum Altitude"=55
                I:"Floored Cavern Minimum Altitude"=21
            }
        }
        "water regions" {
            D:"Water Region Spawn Chance"=0
        }
        miscellaneous {
            I:"Liquid Altitude"=31
            B:"Override Surface Detection"=true
        }
    }
}

An important note: the whitelisting settings (Enable Global Whitelisting and Whitelisted Dimension IDs) are only valid in the base config. These values cannot be overridden in dimension-specific configs.

Advanced Hidden Settings

Previously, certain parameters related to noise generation for caves and caverns were completely hidden from the user. Now, these parameters can be changed in the config file, despite not appearing in the file by default. Note that these settings will never appear in the in-game config. They can only be changed via editing the config file(s).

IMPORTANT: Advanced hidden settings can only be overridden in dimension-specific configs. They do not work in the base config!

Warning: these settings are very sensitive, and should only be messed with if you know what you're doing.

Liquid and Lava Caverns have the following parameters available:

  • Fractal Frequency: Frequency used in ridged multi-fractal noise generation
  • Fractal Gain: The gain for successive octaves of ridged multi-fractal noise generation
  • Fractal Octaves: Number of octaves used for ridged multi-fractal noise generation
  • Noise Threshold: Blocks with generated noise values below this threshold are dug out.
  • Noise Type: Type of noise to use for this carver. This is an enum value from the FastNoise Java library.
  • Number of Generators: Number of noise generation functions used. The intersection of these values is used to calculate a single noise value.

Type 1 & 2 Caves have the aforementioned parameters, as well as the following:

  • Enable y-adjustment: The noise value for each block is weighed by the noise value(s) of block(s) above it. Increases headroom for the player.
  • y-adjustment Variable 1: Determines how much the noise value for the block above a given block impacts that block's noise value.
  • y-adjustment Variable 2: Determines how much the noise value for the block 2 blocks above a given block impacts that block's noise value.

For more information on these values and how to override them, see the example below. Each of these options is in the advanced section of their respective cave/cavern config section.

Example Config with Hidden Advanced Settings

general {
    # This file is an example DIMENSION-SPECIFIC config with comments for everything and default values.
    # All advanced hidden parameters are visible in this file. Be careful messing with these.
    #
    # Note that if used as the base config, the advanced options in this file will not be read.
    # This file is not intended to be used as the base config. There's no reason to try to use this
    # as a replacement to the default base config.

    ##########################################################################################################
    # underground generation
    #--------------------------------------------------------------------------------------------------------#
    # Configure settings related to caves, caverns, ravines and more.
    ##########################################################################################################

    "underground generation" {

        ##########################################################################################################
        # caves
        #--------------------------------------------------------------------------------------------------------#
        # Settings used in the generation of caves.
        ##########################################################################################################

        caves {
            # Determines how large cave regions are.
            #     Controls how long a cave system of a certain cave type extends before intersecting with a cave system of another type.
            #     Larger = more cave interconnectivity for a given area, but less variation.
            # Default: Small (recommended).
            # Valid values:
            # Small
            # Medium
            # Large
            # ExtraLarge
            # Custom
            S:"Cave Region Size"=Small

            # Custom value for cave region size. Smaller value = larger regions. This value is very sensitive to change.
            #     ONLY WORKS IF Cave Region Size IS Custom.
            #     Provided values:
            #         Small: 0.008
            #         Medium: 0.005
            #         Large: 0.0032
            #         ExtraLarge: 0.001
            # Default: 0.008
            # Min: 0.0
            # Max: 0.05
            D:"Cave Region Size Custom Value"=0.00800000037997961

            # Percent chance of caves spawning in a given region.
            # Default: caves spawn in 100% of regions.
            # Min: 0.0
            # Max: 100.0
            D:"Cave Spawn Chance"=100.0

            ##########################################################################################################
            # type 1 caves
            #--------------------------------------------------------------------------------------------------------#
            # Settings used in the generation of type 1 caves, which are more worm-like.
            ##########################################################################################################

            "type 1 caves" {
                # Stretches caves horizontally. Lower value = wider caves.
                # Default: 1.6 (recommended)
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Horizontal"=1.600000023841858

                # Stretches caves vertically. Lower value = taller caves with steeper drops.
                # Default: 5.0 (recommended)
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Vertical"=5.0

                # The maximum y-coordinate at which type 1 caves can generate.
                # Default: 80
                # Min: 0
                # Max: 255
                I:"Type 1 Cave Maximum Altitude"=80

                # The minimum y-coordinate at which type 1 caves can generate.
                # Default: 1
                # Min: 0
                # Max: 255
                I:"Type 1 Cave Minimum Altitude"=1

                # Determines how frequently Type 1 Caves spawn. 0 = will not spawn at all.
                # Default: 10
                # Min: 0
                # Max: 10
                I:"Type 1 Cave Priority"=10

                # The depth from a given point on the surface at which type 1 caves start to close off.
                #     Will use the Max Cave Altitude instead of surface height if it is lower.
                #     Will use the Max Cave Altitude no matter what if Override Surface Detection is enabled.
                # Default: 15 (recommended)
                # Min: 0
                # Max: 255
                I:"Type 1 Cave Surface Cutoff Depth"=15

                ##########################################################################################################
                # advanced settings
                #--------------------------------------------------------------------------------------------------------#
                # Don't mess with these if you don't know what you're doing.
                ##########################################################################################################

                "advanced settings" {
                    # Enable y-adjustment, giving players more headroom in caves.
                    # Default: true
                    B:"Enable y-adjustment"=true

                    # The frequency for ridged multi-fractal noise generation.
                    #     This determines how spread out or tightly knit cave systems are.
                    # Default: 0.03
                    D:"Fractal Frequency"=0.029999999329447746

                    # The gain for successive octaves of ridged multi-fractal noise generation.
                    # Default: 0.3
                    D:"Fractal Gain"=0.30000001192092896

                    # The number of octaves used for ridged multi-fractal noise generation.
                    # Default: 1
                    I:"Fractal Octaves"=1

                    # Noise threshold for determining which blocks get mined out as part of cave generation
                    #     Blocks with generated noise values greater than this threshold will be dug out.
                    # Default: 0.95
                    # Min: -1.0
                    # Max: 1.0
                    D:"Noise Threshold"=0.949999988079071

                    # Type of noise to use for this cave. 
                    # Default: CubicFractal
                    # Valid values:
                    # Value
                    # ValueFractal
                    # Perlin
                    # PerlinFractal
                    # Simplex
                    # SimplexFractal
                    # Cellular
                    # WhiteNoise
                    # Cubic
                    # CubicFractal
                    S:"Noise Type"=CubicFractal

                    # The number of noise generation functions used.
                    #     The intersection of these functions is used to calculate a single noise value.
                    #     Increasing this may decrease performance.
                    # Default: 2
                    I:"Number of Generators"=2

                    # Adjustment factor affecting the block immediately above a given block.
                    #     Higher value will tend to increase the headroom in caves.
                    # Default: 0.9
                    # Min: 0.0
                    # Max: 1.0
                    D:"y-adjustment Variable 1"=0.8999999761581421

                    # Adjustment factor affecting the block two blocks above a given block.
                    #     Higher value will tend to increase the headroom in caves.
                    # Default: 0.9
                    # Min: 0.0
                    # Max: 1.0
                    D:"y-adjustment Variable 2"=0.8999999761581421
                }

            }

            ##########################################################################################################
            # type 2 caves
            #--------------------------------------------------------------------------------------------------------#
            # Settings used in the generation of type 2 caves, which tend to be more open and spacious.
            ##########################################################################################################

            "type 2 caves" {
                # Stretches caves horizontally. Lower value = wider caves.
                # Default: 0.9 (recommended)
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Horizontal"=0.8999999761581421

                # Stretches caves vertically. Lower value = taller caves with steeper drops.
                # Default: 2.2 (recommended)
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Vertical"=2.200000047683716

                # The maximum y-coordinate at which type 2 caves can generate.
                # Default: 80
                # Min: 0
                # Max: 255
                I:"Type 2 Cave Maximum Altitude"=80

                # The minimum y-coordinate at which type 2 caves can generate.
                # Default: 1
                # Min: 0
                # Max: 255
                I:"Type 2 Cave Minimum Altitude"=1

                # Determines how frequently Type 2 Caves spawn. 0 = will not spawn at all.
                # Default: 5
                # Min: 0
                # Max: 10
                I:"Type 2 Cave Priority"=5

                # The depth from a given point on the surface at which type 2 caves start to close off.
                #     Will use the Max Cave Altitude instead of surface height if it is lower.
                #     Will use the Max Cave Altitude no matter what if Override Surface Detection is enabled.
                # Default: 15 (recommended)
                # Min: 0
                # Max: 255
                I:"Type 2 Cave Surface Cutoff Depth"=15

                ##########################################################################################################
                # advanced settings
                #--------------------------------------------------------------------------------------------------------#
                # Don't mess with these if you don't know what you're doing.
                ##########################################################################################################

                "advanced settings" {
                    # Enable y-adjustment, giving players more headroom in caves.
                    # Default: true
                    B:"Enable y-adjustment"=true

                    # The frequency for ridged multi-fractal noise generation.
                    #     This determines how spread out or tightly knit cave systems are.
                    # Default: 0.025
                    D:"Fractal Frequency"=0.02500000037252903

                    # The gain for successive octaves of ridged multi-fractal noise generation.
                    # Default: 0.3
                    D:"Fractal Gain"=0.30000001192092896

                    # The number of octaves used for ridged multi-fractal noise generation.
                    # Default: 1
                    I:"Fractal Octaves"=1

                    # Noise threshold for determining which blocks get mined out as part of cave generation
                    #     Blocks with generated noise values greater than this threshold will be dug out.
                    # Default: 0.82
                    # Min: -1.0
                    # Max: 1.0
                    D:"Noise Threshold"=0.8199999928474426

                    # This value is currently unused for Type 2 caves. 
                    # Valid values:
                    # Value
                    # ValueFractal
                    # Perlin
                    # PerlinFractal
                    # Simplex
                    # SimplexFractal
                    # Cellular
                    # WhiteNoise
                    # Cubic
                    # CubicFractal
                    S:"Noise Type"=SimplexFractal

                    # The number of noise generation functions used.
                    #     The intersection of these functions is used to calculate a single noise value.
                    #     Increasing this may decrease performance.
                    # Default: 2
                    I:"Number of Generators"=2

                    # Adjustment factor affecting the block immediately above a given block.
                    #     Higher value will tend to increase the headroom in caves.
                    # Default: 0.95
                    # Min: 0.0
                    # Max: 1.0
                    D:"y-adjustment Variable 1"=0.949999988079071

                    # Adjustment factor affecting the block two blocks above a given block.
                    #     Higher value will tend to increase the headroom in caves.
                    # Default: 0.5
                    # Min: 0.0
                    # Max: 1.0
                    D:"y-adjustment Variable 2"=0.5
                }

            }

            ##########################################################################################################
            # surface caves
            #--------------------------------------------------------------------------------------------------------#
            # Settings used in the generation of vanilla-like caves near the surface.
            ##########################################################################################################

            "surface caves" {
                # Set to true to enable vanilla-like caves which provide nice, natural-looking openings at the surface.
                # Default: true
                B:"Enable Surface Caves"=true

                # The density of surface caves. Higher = more caves, closer together. 
                # Default: 17
                # Min: 0
                # Max: 100
                I:"Surface Cave Density"=17

                # The maximum y-coordinate at which surface caves can generate.
                # Default: 128
                # Min: 0
                # Max: 255
                I:"Surface Cave Maximum Altitude"=128

                # The minimum y-coordinate at which surface caves can generate.
                # Default: 40
                # Min: 0
                # Max: 255
                I:"Surface Cave Minimum Altitude"=40
            }

            ##########################################################################################################
            # vanilla caves
            #--------------------------------------------------------------------------------------------------------#
            # Settings controlling vanilla Minecraft cave generation.
            ##########################################################################################################

            "vanilla caves" {
                # The density of vanilla caves. Higher = more caves, closer together. 
                # Default: 14 (value used in vanilla)
                # Min: 0
                # Max: 100
                I:"Vanilla Cave Density"=14

                # The maximum y-coordinate at which vanilla caves can generate.
                # Default: 128
                # Min: 0
                # Max: 255
                I:"Vanilla Cave Maximum Altitude"=128

                # The minimum y-coordinate at which vanilla caves can generate.
                # Default: 8
                # Min: 0
                # Max: 255
                I:"Vanilla Cave Minimum Altitude"=8

                # Determines how frequently vanilla caves spawn. 0 = will not spawn at all.
                # Default: 0
                # Min: 0
                # Max: 10
                I:"Vanilla Cave Priority"=0
            }

        }

        ##########################################################################################################
        # caverns
        #--------------------------------------------------------------------------------------------------------#
        # Settings used in the generation of caverns. Caverns are spacious caves at low altitudes.
        ##########################################################################################################

        caverns {
            # Determines how large cavern regions are. This controls the average size of caverns.
            # Default: Small
            # Valid values:
            # Small
            # Medium
            # Large
            # ExtraLarge
            # Custom
            S:"Cavern Region Size"=Small

            # Custom value for cavern region size. Only works if Cavern Region Size is set to Custom.     Smaller value = larger regions. This value is very sensitive to change.
            #     Provided values:
            #         Small: 0.01
            #         Medium: 0.007
            #         Large: 0.005
            #         ExtraLarge: 0.001
            # Default: 0.01
            # Min: 0.0
            # Max: 0.05
            D:"Cavern Region Size Custom Value"=0.009999999776482582

            # Percent chance of caverns spawning in a given region.
            # Default: caverns spawn in 25% of regions.
            # Min: 0.0
            # Max: 100.0
            D:"Cavern Spawn Chance"=25.0

            ##########################################################################################################
            # liquid caverns
            #--------------------------------------------------------------------------------------------------------#
            # Settings used in the generation of Liquid Caverns found at low altitudes.
            #     These are caverns where the floor is predominantly water or lava.
            ##########################################################################################################

            "liquid caverns" {
                # Stretches caverns horizontally. Lower value = more open caverns with larger features.
                # Default: 0.7
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Horizontal"=0.699999988079071

                # Stretches caverns vertically. Lower value = more open caverns with larger features.
                # Default: 1.3
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Vertical"=1.2999999523162842

                # The maximum y-coordinate at which Liquid Caverns can generate.
                #     Caverns will attempt to close off anyway if this value is greater than the surface's altitude.
                # Default: 35
                # Min: 0
                # Max: 255
                I:"Liquid Cavern Maximum Altitude"=35

                # The minimum y-coordinate at which Liquid Caverns can generate.
                # Default: 1
                # Min: 0
                # Max: 255
                I:"Liquid Cavern Minimum Altitude"=1

                # Determines how frequently Liquid Caverns spawn. 0 = will not spawn at all.
                # Default: 10
                # Min: 0
                # Max: 10
                I:"Liquid Cavern Priority"=10

                ##########################################################################################################
                # advanced settings
                #--------------------------------------------------------------------------------------------------------#
                # Don't mess with these if you don't know what you're doing.
                ##########################################################################################################

                "advanced settings" {
                    # The frequency for ridged multi-fractal noise generation.
                    #     This determines how spread out or tightly knit the formations in caverns are.
                    # Default: 0.03
                    D:"Fractal Frequency"=0.029999999329447746

                    # The gain for successive octaves of ridged multi-fractal noise generation.
                    # Default: 0.3
                    D:"Fractal Gain"=0.30000001192092896

                    # The number of octaves used for ridged multi-fractal noise generation.
                    # Default: 1
                    I:"Fractal Octaves"=1

                    # Noise threshold for determining which blocks get mined out as part of cavern generation
                    #     Blocks with generated noise values lower than this threshold will be dug out.
                    # Default: 0.6
                    # Min: -1.0
                    # Max: 1.0
                    D:"Noise Threshold"=0.6000000238418579

                    # Type of noise to use for this cavern. 
                    # Default: SimplexFractal
                    # Valid values:
                    # Value
                    # ValueFractal
                    # Perlin
                    # PerlinFractal
                    # Simplex
                    # SimplexFractal
                    # Cellular
                    # WhiteNoise
                    # Cubic
                    # CubicFractal
                    S:"Noise Type"=SimplexFractal

                    # The number of noise generation functions used.
                    #     The intersection of these functions is used to calculate a single noise value.
                    #     Increasing this may decrease performance.
                    # Default: 2
                    I:"Number of Generators"=2
                }

            }

            ##########################################################################################################
            # floored caverns
            #--------------------------------------------------------------------------------------------------------#
            # Parameters used in the generation of Floored Caverns.
            #     These have much more ground to walk on than Liquid Caverns.
            ##########################################################################################################

            "floored caverns" {
                # Stretches caverns horizontally. Lower value = more open caverns with larger features.
                # Default: 0.7
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Horizontal"=0.699999988079071

                # Stretches caverns vertically. Lower value = more open caverns with larger features.
                # Default: 1.3
                # Min: 0.0
                # Max: 100.0
                D:"Compression - Vertical"=1.2999999523162842

                # The maximum y-coordinate at which Floored Caverns can generate.
                #     Caverns will attempt to close off anyway if this value is greater than the surface's altitude.
                # Default: 35
                # Min: 0
                # Max: 255
                I:"Floored Cavern Maximum Altitude"=35

                # The minimum y-coordinate at which Floored Caverns can generate.
                # Default: 1
                # Min: 0
                # Max: 255
                I:"Floored Cavern Minimum Altitude"=1

                # Determines how frequently Floored Caverns spawn. 0 = will not spawn at all.
                # Default: 10
                # Min: 0
                # Max: 10
                I:"Floored Cavern Priority"=10

                ##########################################################################################################
                # advanced settings
                #--------------------------------------------------------------------------------------------------------#
                # Don't mess with these if you don't know what you're doing.
                ##########################################################################################################

                "advanced settings" {
                    # The frequency for ridged multi-fractal noise generation.
                    #     This determines how spread out or tightly knit the formations in caverns are.
                    # Default: 0.028
                    D:"Fractal Frequency"=0.02800000086426735

                    # The gain for successive octaves of ridged multi-fractal noise generation.
                    # Default: 0.3
                    D:"Fractal Gain"=0.30000001192092896

                    # The number of octaves used for ridged multi-fractal noise generation.
                    # Default: 1
                    I:"Fractal Octaves"=1

                    # Noise threshold for determining which blocks get mined out as part of cavern generation
                    #     Blocks with generated noise values lower than this threshold will be dug out.
                    # Default: 0.6
                    # Min: -1.0
                    # Max: 1.0
                    D:"Noise Threshold"=0.6000000238418579

                    # Type of noise to use for this cavern. 
                    # Default: SimplexFractal
                    # Valid values:
                    # Value
                    # ValueFractal
                    # Perlin
                    # PerlinFractal
                    # Simplex
                    # SimplexFractal
                    # Cellular
                    # WhiteNoise
                    # Cubic
                    # CubicFractal
                    S:"Noise Type"=SimplexFractal

                    # The number of noise generation functions used.
                    #     The intersection of these functions is used to calculate a single noise value.
                    #     Increasing this may decrease performance.
                    # Default: 2
                    I:"Number of Generators"=2
                }

            }

        }

        ##########################################################################################################
        # water regions
        #--------------------------------------------------------------------------------------------------------#
        # Settings used in the generation of water regions.
        ##########################################################################################################

        "water regions" {
            # Percent chance of a region having water instead of lava at low altitudes.
            # Default: 40%
            # Min: 0.0
            # Max: 100.0
            D:"Water Region Spawn Chance"=40.0

            # Custom value for water region size. Smaller value = larger regions. This value is very sensitive to change.
            #     ONLY WORKS IF Water Region Size IS Custom.
            #     Provided values:
            #         Small: 0.008
            #         Medium: 0.004
            #         Large: 0.0028
            #         ExtraLarge: 0.001
            # Default: 0.004
            # Min: 0.0
            # Max: 0.05
            D:"Water Region Size Custom Value"=0.004000000189989805

            # Percent chance of a region having water instead of lava at low altitudes.
            # Default: 40%
            # Min: 0.0
            # Max: 100.0
            D:"Water Region Spawn Chance"=40.0
        }

        ##########################################################################################################
        # ravines
        #--------------------------------------------------------------------------------------------------------#
        # Settings used for ravine generation.
        ##########################################################################################################

        ravines {
            # Set to true to enable flooded ravines in ocean biomes.
            # Default: true
            B:"Enable Flooded Ravines"=true

            # Set to true to enable ravine generation.
            # Default: true
            B:"Enable Ravines"=true
        }

        ##########################################################################################################
        # miscellaneous
        #--------------------------------------------------------------------------------------------------------#
        # Miscellaneous settings used in cave and cavern generation.
        ##########################################################################################################

        miscellaneous {
            # Set to true to enable flooded underground in ocean biomes.
            # Default: true
            B:"Enable Flooded Underground"=true

            # The block used for lava generation at and below the Liquid Altitude.
            #     Defaults to regular lava if an invalid block is given.
            # Default: minecraft:lava
            S:"Lava Block"=minecraft:lava

            # Lava (or water in water regions) spawns at and below this y-coordinate.
            # Min: 0
            # Max: 255
            I:"Liquid Altitude"=10

            # Ignores surface detection for closing off caves and caverns, forcing them to spawn
            #     up until their max height. Useful for Nether-like dimensions with no real "surface".
            # Default: false
            B:"Override Surface Detection"=false

            # Replace naturally generated floating gravel on the ocean floor with andesite.
            #     Can prevent lag due to cascading gravel falling into caverns under the ocean.
            # Default: true
            B:"Prevent Cascading Gravel"=true

            # The block used for water generation in water caves/caverns at and below the Liquid Altitude.
            #     Defaults to regular water if an invalid block is given.
            # Default: minecraft:water
            S:"Water Block"=minecraft:water
        }

    }

    ##########################################################################################################
    # bedrock generation
    #--------------------------------------------------------------------------------------------------------#
    # Configure how bedrock generates in the overworld and nether.
    ##########################################################################################################

    "bedrock generation" {
        # The width of the bedrock layer. Only works if Flatten Bedrock is true.
        # Min: 0
        # Max: 256
        I:"Bedrock Layer Width"=1

        # Replaces the usual bedrock generation pattern with flat layers.
        #     Activates in all whitelisted dimension, where applicable. The End is unaffected.
        B:"Flatten Bedrock"=true
    }

    ##########################################################################################################
    # debug settings
    #--------------------------------------------------------------------------------------------------------#
    # Don't mess with these settings for normal gameplay.
    ##########################################################################################################

    "debug settings" {
        # The visualizer creates worlds where there are no blocks except those indicating where caves
        #     and caverns would be carved out in a regular world. This is useful for visualizing the kinds of
        #     caves and caverns your current config options will create.
        #     Type 1 Cave: Wooden Planks
        #     Type 2 Cave: Cobblestone
        #     Lava Cavern: Redstone Block
        #     Floored Cavern: Gold Block
        #     Surface Cave: Emerald Block
        #     Vanilla Cave: Bricks
        # Default: false
        B:"Enable DEBUG Visualizer"=false
    }

}