Cloud Cover

Description

Matches when the share of the sky around the entity that holds cloud, from 0 (clear) to 1 (full), is inside a range. The <mythicseasons.cloudcover> placeholder reports the same number, always for a radius of 256 blocks.

This condition works on any entity and reads the sky around it. Without an entity it is false.

The cover comes from the atmosphere simulation: the share of cloudy samples, among those the simulation has data for, in a square reaching radius blocks to each side, one weather cell apart (grid.cell-size.xz, 32 blocks by default). The point under the entity is sampled only when the radius is a multiple of the cell size. With any other radius it is skipped, and a small radius can read a neighbouring cell.

The condition is false while the atmosphere is off (enabled: false in atmosphere.yml), in a world that is not simulated, where the simulation has not covered the area yet, and in a WorldGuard region with season-atmosphere set to deny.

Attributes

Attribute Aliases Description Default
radius r How far the square reaches to each side, whole blocks. 256
min minimum The lowest matching cover, 0 to 1. no limit
max maximum The highest matching cover, 0 to 1. no limit

Both limits are included, and with no attribute every cover that can be measured matches. For an exact cover write min=0.5;max=0.5. When min is higher than max, nothing matches.

Range argument

The range can also be a bare argument after the name and any braces, as in cloudcover{r=512} >=0.5 true, in a Conditions:, TargetConditions: or TriggerConditions: line, only when neither min nor max is set. Shapes: >0.5, >=0.5, <0.5, <=0.5, 0.2to0.6, 0.2-0.6 and 0.5.

Examples

WinterOvercastChill:
  Cooldown: 2
  Conditions:
  - season{season=winter} true
  - cloudcover{min=0.7} true
  Skills:
  - modifytemp{id=overcast;amount=-3;duration=3} @Self

Cools a player in winter under a sky that is 70 percent cloud or more.

WideOvercastNotice:
  Conditions:
  - cloudcover{r=512} >=0.5 true
  Skills:
  - message{m="The sky is mostly overcast."} @Self

A 512-block radius, with the range as a bare argument after the braces.

ClearSkyNotice:
  Skills:
  - message{m="Not a cloud in sight."} @Self ?cloudcover{max=0.1}

Inline, with the braces form.

Aliases

  • atmospherecloudcover
  • overcast
Updated Nov 11, 2026