Cloud Layers

 A customizable mod that adds multiple layers of clouds. It also brings 1.21.6+ cloud features to older versions. ### Features (as of v2.1) - Multiple cloud layers - Clouds render further out - New 1.21.6+ clouds.png texture - Fully customizable using the configuration menu - Supports resource packs ### Default Layers By default, there are two layers of clouds: - **_Fancy_** style clouds at Y: 160 - **_Fast_** style clouds at Y: 256 The lower layer uses the new 1.21.6+ cloud texture, while the upper layer uses the pre 1.21.6 texture. They resemble Cumulus and Cirrus clouds.   ### Custom Layers You can add or edit existing cloud layers using the config menu (accessible with mod menu). Or edit the config file at _config/cloud-layers.json_.   ### Cloud Appearance Use the following options to change the shape and appearance of clouds: - _Thickness_, the vertical width of the cloud layer - If 0, they are rendered as **_Fast_** style clouds - Vanilla **_Fancy_** style clouds have thickness 4 - _Scale_, the horizontal width of each cloud pixel - This is always 12 in vanilla - _Texture_, the cloud texture used to render clouds - "NEW", the new texture added in 1.21.6+ vanilla MC - "OLD", this is the original texture before 1.21.6 - "OVERCAST", the cloud layer covers the sky completely You can also change the color and transparency of clouds. The lower the alpha, the more transparent they are.   ### Cloud Movement You can change the speed that clouds move, and select the direction of movement.  The option _Skybox Mode_ makes a cloud layer appear to stay fixed in the sky, regardless of how high the player goes, this creates a skybox effect. ### Conditions You can make a layer only show up when certain conditions are met, like only when raining or during the night. ### Other Info Clouds in MC settings must be set to "Layers" or "Fancy", for the mod to render its clouds. Resource Packs Resource packs have much more control over cloud layers, using json files. ### Layer files Cloud layers are defined by .json files stored in _assets/cloud_layers/layers/_. - __height__ (mandatory): Y position at the bottom of the layer. - __scale__: How many blocks wide each cloud cell is. - __skybox_mode__: Either true or false, skybox mode is described above. - __velocity__: [x, z] Movement of the layer in blocks per second. - __offset__: [x, z] Initial position, useful to prevent layers matching. - __color__: Either [red, green, blue, alpha] or Texture Map (see below). - __opacity__: Single value between 0 and 1, or Texture Map. This is in addition to __color__'s alpha value. It can be used to make large areas of clear sky. - __thickness__: Single value or Texture Map, this is how many blocks above __height__ the layer extends. More fields will be added in the future, for more complex weather / cloud systems. #### Texture Map Texture maps can be used to have different values across a single layer. Like __thickness__ varying from one cloud to the next. - __texture__ (mandatory): Full resource location for the texture used. - __multiply__ (mandatory): [red, green, blue, alpha], each channel is multiplied by these. For single value fields, they are then added together. - __scale__: How many cells each pixel in the map corresponds to. - __velocity__: [x, z] Movement of the texture map in cells per second. - __offset__: [x, z] Offset in cells - __add__: Value or Texture Map, this is added to the final value. Does not work in __color__. #### Example (default lower layer at _assets/cloud_layers/layers/lower.json_) ``` { "height": 160, "scale": 12, "velocity": [-0.6, 0], "color": { "texture": "cloud_layers:textures/color/new_vanilla.png", "multiply": [ 1, 1, 1, 0.9 ] }, "thickness": 4 } ``` ### layers.json (_assets/cloud_layers/layers.json_) This file defines which layers render in each dimension, and also their conditions (weather, time, etc.). The file should contain fields for each dimension with a list of layer entries: - __layer__: The layer's resource location, without "layer/" or ".json". - __weather__: Which types of weather can the layer appear in: - __clear__: Either true or false. - __rain__: Either true or false. - __thunder__: Either true or false. - __time__: Time of day range the layer is visible for. - __start__: Between 0 and 24000 - __end__: Between 0 and 24000 There can be multiple entries for the same layer, for different sets of conditions. #### Example ``` { "minecraft:overworld": [ { "layer": "cloud_layers:upper" }, { "layer": "cloud_layers:lower", "weather": {"clear": true, "rain": true, "thunder": false} }, { "layer": "cloud_layers:storm_clouds", "weather": { "clear": false, "rain": false, "thunder": true } }, { "layer":"cloud_layers:morning_fog", "time": { "start": 22000, "end": 1000 } } ], "some_mod:custom_dimension": [ { "layer": "cloud_layers:storm_clouds" } ] } ``` ### Cell Texture The texture used to render cloud cell walls. It is stored at _assets/cloud_layers/textures/cell.png_.