Built In Layers

The plugin ships eight cloud layer files in plugins/MythicSeasons/cloud-layers/. Only cumulus is drawn as shipped (clouds.layers: [cumulus] in atmosphere.yml). To show others, add their names to a clouds.layers list, see Layers.

The files are never overwritten, and a deleted one comes back at the next load, so take a layer out of clouds.layers instead. Each file explains its settings in comments.

The shipped layers

Layer Type Shape Draws Drawn by Toggle name
cumulus simulated none The weather's own clouds The shipped clouds.layers cumulus
ground-fog surface-humidity none Thin fog on the land Adding it to a list fog
fog-banks surface-humidity steps Fog in banks with clear lanes between them Adding it in place of ground-fog fog
cirrus outflow fibrous High see-through streaks Adding it to a list cirrus
cirrus-hooks outflow hooked High tufts with tails Adding it, alone or with cirrus cirrus
cirrostratus outflow veil A faint high veil Adding it to a list cirrus
mars-dust surface-wind none Orange dust lifted by the wind The mars profile dust
mars-ice noise none Thin high ice clouds The mars profile cirrus

Players hide layers for themselves with /togglecloudlayer <toggle name>, and layers that share a name hide together, see Player toggles.

clouds:
  layers: [cumulus, ground-fog, cirrus, cirrostratus]

Works in atmosphere.yml, a world, a season file or a profile, see Choosing the layers.

cumulus

The weather's own clouds, solid and in the biome cloud colours. As the first solid layer of the shipped list, cumulus is the cloud players can be inside, and rain, snow and thunder only show where it draws cloud overhead.

The file sets type: simulated, forms-at: 0.0, full-at: 0.5 and toggle: cumulus, with every other setting at its default. The shipped seasons change forms-at, full-at and lift in their atmosphere block:

Season forms-at full-at lift
spring 0.275 0.775 160
summer 0.28 0.78 160
fall 0.29 0.79 160
winter 0.0, from the file 0.24 160
  • lift 160 draws the clouds 160 blocks above where the weather forms them, less over ground above y160 and not at all from y320 (ground-clearance-cap), see Height and position.
  • The season blocks win over worlds.<world>.cloud-layers.cumulus in atmosphere.yml, see Changing one layer.
  • The shipped example profile turns cumulus into a heavy, dark overcast, see Profiles.

Fog layers

ground-fog and fog-banks draw see-through fog on the land where the ground air is near saturation, such as on cool damp nights and after rain. Draw one of the two. ground-fog is a thin plain layer, and fog-banks gathers the fog into banks with clear lanes between them, full at the ground and thinning upward. Both follow the real ground (ground-grid), and land whose chunks have not been loaded since the start gets no fog.

Setting ground-fog fog-banks
forms-at, full-at 0.9, 1.0 0.9, 1.0
opacity, color 0.4, "DDE3E8" 0.4, "DDE3E8"
voxel-size, voxel-height 16, 4 16, 8
max-distance 256 256
thickness 17 24
ground-clearance, ground-clearance-cap 0, 2032 0, 2032
ground-grid, ground-sink 32, 17 32, 0
haze-shells, haze-distance, haze-opacity 4, 6, 0.12 4, 6, 0.12
Pattern noise-scale 96, noise-scale-y 32 A shape from one noise step: size 320, octaves 1, cover 0.6, vertical: dome
toggle fog fog
  • Small cloud blocks cost many entities, so keep max-distance short.
  • With ground-grid: 0 the fog follows the highest terrain of each weather cell and can float above valleys.
  • Seasons can change cover and steps.banks.size of fog-banks, see Shapes.

High cloud layers

cirrus, cirrus-hooks and cirrostratus are see-through bands above the top of the simulated sky (y320 on a default overworld). Storm outflow feeds them, so a calm sky keeps only their patches. With angle 0 and snap 90 they lie north-south or east-west, whichever is closer to the wind, and drift slowly with the outflow wind.

  • cirrus draws long thin streaks in one row of cloud blocks 168 blocks above the sky top (y488), above the cumulus lift of the shipped seasons.
  • cirrus-hooks draws mares' tails: sparse tufts in the top two of five rows (y488 to y528), with tails that trail upwind and step down through the rows below.
  • cirrostratus draws a faint wide veil with ragged streaks 216 blocks above the sky top (y536), just over the hooks. Weaker outflow is enough for it.
Setting cirrus cirrus-hooks cirrostratus
forms-at, full-at 0.15, 0.6 0.15, 0.6 0.1, 0.5
opacity 0.2 0.25 0.15
color "F4F7FC" "F4F7FC" "F2F4F8"
voxel-size, voxel-height 16, 8 16, 8 32, 8
thickness, top-clearance 8, 168 40, 168 8, 216
visible-from-inside false false false
Shape fibrous: length 1000, spacing 160, bend 0.35, fray 0.3 hooked: spacing 240, length 600, curl 0.8 veil: size 1400, length 1200, spacing 200, streaks 0.4
cover 0.3 0.15 0.8
patches share, size, edge 0.25, 2600, 0.3 0.2, 2400, 0.3 0.3, 5000, 0.4
drift-scale 0.25 0.25 0.25
toggle cirrus cirrus cirrus

clouds.outflow in atmosphere.yml sets how long the outflow lingers and which wind carries these bands, see Storms. The shape settings are on Shapes.

Mars layers

The mars profile (atmosphere-profiles/mars.yml):

  • makes the world freezing (temperature: -60) and bone-dry (humidity: 0.0),
  • adds a stronger upper wind (forcing.wind.speed-base: 9.0),
  • stops all rain (physics.auto-rate: 0.0),
  • draws clouds.layers: [mars-dust, mars-ice] instead of cumulus,
  • keeps the seasons' tints off these layers (clouds.tint: "FFFFFF").

mars-dust is an orange see-through haze lifted where the ground wind is strong, resting on the highest terrain of each weather cell. mars-ice draws thin high ice clouds in a steady pattern that ignores the weather. Its file's comment says they cover about a third of the sky at a coverage of 0.8, half at 1.0 and most of it from 1.2.

Setting mars-dust mars-ice
forms-at, full-at 3.0, 7.0 The defaults
coverage 1.2 0.8
opacity, color 0.4, "C8763F" 0.3, "E6EDF7"
voxel-size, voxel-height 16, 8 32 (default), 8
max-distance 1024 8192 (default)
Placement thickness 48, ground-clearance 0, ground-clearance-cap 2032 thickness 16, min-y 300
Pattern noise-scale 192, noise-scale-y 64 noise-scale 520, noise-scale-y 64
toggle dust cirrus
worlds:
  red_planet:
    profile: mars

In atmosphere.yml, followed by /ms reload: red_planet is Mars in every season. Its atmosphere starts when it gets a season, or turn it on with /ms atmosphere toggle red_planet.

  • A world profile wins over the season files, except their own atmosphere.worlds.<world> blocks.
  • Mars has no solid layer, so the in-cloud checks answer "not in a cloud" there.
  • The blowing dust particles come from the MS_MarsDust skill of the bundled MythicMobs pack. The pack never replaces existing files, so an install from before that skill needs it added to skills/Atmosphere.yml by hand, see Packs.
Updated Nov 11, 2026