Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
A customizable mod that adds multiple layers of clouds. It also brings 1.21.6+ cloud features to older versions (the new texture and cloud rendering beyond the render distance.
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).
- 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.
Example (default lower layer at assets/cloud_layers/layers/lower.json)
{
"height": 160,
"scale": 12,
"velocity": [-0.6, 0],
"color": {
"texture": "cloud_layers:textures/new_clouds.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.