Tutorial: Dimension Configuration

This tutorial assumes that you have already created a Json configuration file. If you haven't please read [[https://github.com/OreCruncher/DynamicSurroundings/wiki/Tutorial:-External-Configuration-Files][Tutorial: External Configuration Files]]. 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.| |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: #+BEGIN_EXAMPLE { "dimensions":[ { "dimId":-1, "weather":true, "haze":false, "aurora":false, "seaLevel":0 } ] } #+END_EXAMPLE 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.