Options

A season file in plugins/MythicSeasons/seasons/ takes the keys below. Only id is required, and example.yml lists every key with a comment.

• Unknown top-level keys are ignored without a message, so a misspelled key silently keeps its default. The atmosphere block and the populator rules do warn.
• /ms reload reads the files again, except foliage-transitions, which needs a restart. Chunks players already have keep their look until they are sent again.
• The five shipped files come back whenever one is missing, so set enabled: false to turn a shipped season off.
• A weather.daily-extra-downfall-chance or a foliage-transitions weight that is not a number makes the whole file fail with Failed to load season file: <file>.

Identity

• Keep an id to lowercase letters, digits, - and _. A space breaks /ms set, a comma splits the list of the season condition, and disabled is reserved for worlds without a season.
• <mythicseasons.season.display>, <mythicseasons.nextseason>, %ms_season_display% and %ms_next_season_display% keep the tags of display-name, so whatever shows them must read MiniMessage.
• An empty transition-message sends the language file's SEASON-TO-<ID> line, which exists only for spring, summer, fall and winter. send-message-on-season-cycle: false in config.yml turns every transition message off.

Populators

populators holds the season's block rules for snow, ice, flowers and leaf litter, see Populators.

Weather

These keys only change the world's vanilla weather, and only while modify-weather-cycle is true in config.yml.

The extra chance only starts rain after the dry spell that follows every rain (see weather durations) and with has-natural-downfall: true. It never runs where the atmosphere is on.

Biome colours

• The index also decides where the season's populators, snow coverage and block replacements are stored. Two seasons with the same number, -1 included, share them: the season loaded last wins, and a warning names both.
• The shipped seasons take 0 to 3, so a new season normally uses -1. To give it its own rules, turn a shipped season off (enabled: false and out of season-cycle) and take its number, which also gives it that season's colours.
• A missing biome-color-index, or one outside -1 to 3, logs a warning, so write -1 to keep the vanilla colours on purpose.

World rules

Skill triggers

Each key lists MythicMobs skills that run in the worlds in this season, see Triggers.

• world-tick, season-start and season-end do nothing in a world without players.
• Every shipped season runs MS_Atmosphere in player-tick. Without it players get none of the simulated rain, snow, wind or storms.
• Put cosmetic skills in player-tick-particles. In a skill that mixes both, check <mythicseasons.particles> on the particle lines.

Atmosphere

The atmosphere: block changes the weather simulation during this season. It takes every atmosphere.yml setting that can change with the season:

• temperature
• humidity
• biome-defaults
• forcing, except the size, speed and direction of air masses
• physics, except solver-threads
• weather
• clouds.layers, clouds.tint, clouds.storm-fade-seconds, clouds.outflow and clouds.sample-size
• cloud-layers.<layer>.<setting> for one cloud layer

Values can be numbers, quoted operators such as "*1.4", keyframes or formulas, see value forms. A keyframe named after a phase sits in the middle of that phase, by this file's sub-season-thresholds.

Options shows the order in which atmosphere.yml, season-adjustments, profiles and these blocks apply.

Sub-season thresholds

Where each phase ends, in percent of the season. See Sub-Seasons.

Each value must be from 0 to 100 and not below the one before it, or the season uses all four defaults (with a warning). Two equal values remove the phase between them.

Foliage transitions

• Quote the value: an unquoted # starts a YAML comment and leaves the key empty. # and WEIGHT: may be left out ('32CD32,0.3'), and a value without exactly one comma is ignored.
• Only the files of the seasons spring, summer, fall and winter count, see Sub-Seasons.

Examples

id: monsoon
display-name: "<#2E8B57>Monsoon"
transition-message:
  - "<green>The monsoon rains have arrived."
  - "<gray>Expect rain every day."
weather:
  daily-extra-downfall-chance: 50%
biome-color-key: summer
biome-color-index: -1
skill-triggers:
  player-tick:
    - MS_Atmosphere
atmosphere:
  humidity: "*1.4"
  transition:
    blend-days: 5

"*1.4" gives the simulated air 40 percent more moisture.

atmosphere:
  temperature:
    START: -4
    MIDDLE: -14
    END: -6
  cloud-layers:
    cumulus:
      full-at: 0.3
  worlds:
    resource_world:
      physics:
        auto-threshold: 0.4

The season is coldest in its middle, the cumulus layer draws more cloud, and in resource_world cloud turns into rain sooner.