Cloud Layers

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.