Layers

Each cloud layer, such as ground fog or high cirrus, is a file in plugins/MythicSeasons/cloud-layers/, and the list clouds.layers decides which layers a world draws.

• The layer name is the file name without .yml: a-z, 0-9, _ and -, with capitals read as small letters.
• The eight shipped files are copied when missing and never overwritten. A deleted one comes back at the next load, so take the layer out of clouds.layers instead.
• /ms reload reads the folder again. Only the shader looks of styles need a restart.

The layer file

A layer file is flat YAML, and only type is required.

• Settings take every value form of a season block, and an operator such as "*2" works on the built-in default. max-distance takes a formula of view-distance instead, and shape numbers must be plain numbers.
• true and false (and yes, no, on, off) work only for visible-from-inside. Elsewhere they log a warning and keep the default, so turn the floor above the terrain off with ground-clearance: -1.

Choosing the layers

clouds.layers is a YAML list of layer names, not case-sensitive. It can sit in six places:

• The last place in the order on Per-world overrides that sets the list replaces the others whole, so a season file's list wins over worlds.<world> in atmosphere.yml (the shipped seasons set none). To give one world its own list in every season, give it a profile.
• [] draws no clouds.
• A single name without brackets is a list of one, but "cumulus, cirrus" in quotes is one name that matches no file.

worlds:
  resource_world:
    clouds:
      layers: [cumulus, cirrus]

In atmosphere.yml: resource_world draws high cirrus over the weather's clouds.

The order of the list

The order does not decide which layer is drawn in front. It matters here:

• With no solid layer in the list, incloud answers false, cloud base and top read -1, there is no see-through window and rain follows the simulated clouds alone. Put cumulus before any other solid layer, and keep fog and cirrus see-through.
• The Clouds: line of /ms atmosphere stats shows the height range the first solid layer draws where you stand.

Changing one layer

A season, world or profile changes one layer's settings under cloud-layers.<layer>, without touching its file.

atmosphere:
  cloud-layers:
    cumulus:
      coverage: "*1.6"
      forms-at:
        START: 0.3
        MIDDLE: 0.2
        END: 0.3

In a season file: cumulus coverage times 1.6, and forms-at from 0.3 down to 0.2 in mid-season and back.

• The layer file applies first, then the blocks in the order on Per-world overrides. An operator works on the value reached so far.
• The shipped seasons set cumulus forms-at, full-at and lift (winter only full-at and lift), and these win over worlds.<world>. To change them for one world, use a world profile or the season file's atmosphere.worlds.<world> block.
• A block for a layer without a file, or one not in the list at that moment, does nothing and logs nothing.
• cloud-layers is not accepted at the top of atmosphere.yml.
• /ms atmosphere profile [world] lists each drawn layer's settings and where each value comes from.

What can change

Season blends

During a transition between seasons, every number of a layer both seasons draw moves evenly, cloud-layers values, shape numbers and style variables included. The list and the direction of a shape switch at the halfway point.

Creating a layer

1. Copy the shipped file closest to what you want under a new name, such as morning-mist.yml. cumulus.yml lists every setting. ground-fog.yml, cirrus.yml and mars-dust.yml are bands.
2. Edit its settings.
3. Add the name to a clouds.layers list.
4. Run /ms reload and check the layer with /ms atmosphere profile. The Renderer: line of /ms atmosphere stats ends with each layer's faces in your view.

type: surface-humidity
toggle: fog
forms-at: 0.8
full-at: 1.0
opacity: 0.3
color: "E8EDF2"
voxel-size: 16
voxel-height: 8
max-distance: 256
thickness: 16
ground-clearance: 0
ground-clearance-cap: 2032
ground-grid: 32

cloud-layers/morning-mist.yml: ground mist from 80 percent humidity, hidden with the shipped fog by /togglecloudlayer fog.

• Without a thickness of 0 or more, a layer only exists inside the simulated clouds. A band needs a floor (ground-clearance, top-clearance or min-y), or it sits at y-512, out of sight, see Height and position.
• For a guided walk-through, see Custom Cloud Layer.

Console messages

A missing file or an unknown type is reported once until the next /ms reload. Messages about keyframes, formulas and other value forms are on Profiles, those about shapes on Shapes.