Bukkit

Configuration

Configuration - With Multiverse

To create a new normal world with Giant Caves, use the following multiverse command:

• /mv create CaveWorld normal -g GiantCaves To create a new normal world with custom cave settings, use the following multiverse command, substituting your preferred settings:
• /mv create CaveWorld normal -g GiantCaves:sxz=200,sy=100,cutoff=62,miny=6,maxy=50

If you want to add Giant Caves to an existing world, or a world generated with a different world generator, you have to set onlyUseWorldManagers to false in the confg.yml and then configure Giant Caves as described below.

Configuration - No Multiverse

First, set onlyUseWorldManagers to false in config.yml

Within config.yml is a series of key/value pair blocks, one for each world under the "worlds:" key. To bind Giant Caves to a second world, copy the key/value pair block under the existing block.

Cave Generation Options

Below are extended descriptions of each of the configuration keys:

name - The name of a world to apply giant caves. This value must match the name of the world in the bukkit.yml file for Giant Caves to attach.

sxz - Horizontal stretch (larger number = wider cave). This parameter controls the horizontal stretch of the Perlin density map. Making this value larger will stretch the caves horizontally, increasing both the size of the caves and the spacing between them.

sy - Vertical stretch (larger number = taller cave). This parameter controls the vertical stretch of the Perlin density map. Making this value larger will stretch the caves vertically.

cutoff - Minimum Perlin density cutoff (-100 to 100). This parameter controls the Perlin density cutoff point between cave and not cave. Lowering this value will increase the overall volume and frequency of caves. Raising it will do the opposite. Values outside the range will be treated as the maximum or minimum values.

miny - Lower bound of cave zone. The lowest block layer Giant Caves will populate.

maxy - Uppoer bound of cave zone. The highest block layer Giant Caves will populate.

debug - Turns on invert mode for experimenting with config values (true/false). When set to true, Giant Caves will fill caves with stone instead of air. Use this feature in combination with an empty world generator like https://github.com/downloads/rmichela/NullTerrain to visualize the generated cave structures. You can use this visualization to experiment with how the different configuration parameters change the structure of the caves.

For multi-world support, create a separate config block (starts with a dash) for each world.