Dimension Configuration - OreCruncher/BetterRain GitHub Wiki

Internally Dynamic Surroundings has a Dimension Registry where it keeps information related to how it should operate for a dimension. A modpack author can override what Dynamic Surroundings uses in order to provide specific dimension behaviors.

The table below describes the various parameters that can be defined:

Parameter	Value Type	Comment
dimId	Integer	The ID of the dimension the parameters apply.
seaLevel	Integer	The Y block coordinate that defines sea level. Only affects Dynamic Surroundings!
skyHeight	Integer	The Y block coordinate that defines larges Y for building. Only affects Dynamic Surroundings!
cloudHeight	Integer	The Y block coordinate that is considered the cloud layer.
haze	Boolean	Whether to allow elevation haze effect in the dimension.
aurora	Boolean	Whether to allow auroras in the dimension.
weather	Boolean	Whether to allow weather effects in the dimension.

---

1.7.10-1.0.5.1BETA+ and 1.8.9-2.0.5.1BETA+

Parameter	Value Type	Comment
name	String	Name of the dimension. If used dimId does not have to be specified. Match is based on dimension name.

---

In order to define dimension options the first thing that needs to be done is to create a Json file in the ./minecraft/config/dsurround/ configuration directory. It is a normal text file but has a specific Json syntax that must be followed. Here is an example of such a file:

{
    "entries":[
        {
	    "dimId":-1,
	    "weather":true,
	    "haze":false,
	    "aurora":false,
	    "seaLevel":0
	}
    ]
}

In this example, the dimension that is being configured is -1 (The Nether). Weather effects are turned on, elevation haze is disabled, auroras are disabled, and seaLevel is defined to be 0 so that the dust weather effect can render to make it foggy when it is raining.

Once the configuration file is created Dynamic Surroundings needs to be told to process the file during it’s initialization. To do that edit the dsurround.cfg file and set the Config Files parameter:

dimensions {
    # Configuration files for configuring Dimension Registry [default: ]
    S:"Config Files" <
        Witchery.json
     >
}

In this example one external configuration file Witchery.json is defined. Dynamic Surroundings will load and process this config file. If more than one file is specified, each will be processed in order. This means that it would be possible for another configuration file to override what Witchery.json has configured. This is useful for when someone comes up with general settings in support of a mod (such as Biomes O’Plenty), but wants to make some tweaks to give it a different feel.