Wikis / MythicSeasons / Seasons / Sub Seasons

Sub Seasons

Every season is split into five phases, called sub-seasons, by how far the calendar is through it. They blend the biome colours into the neighbouring seasons, and populators, block replacements and the simulated weather can follow them.

The phases

Phase	Number	Default part of the season
`START`	`0`	0 to 9 percent
`EARLY`	`1`	9 to 18 percent
`MIDDLE`	`2`	18 to 84 percent
`LATE`	`3`	84 to 92 percent
`END`	`4`	92 to 100 percent

Phase names are not case-sensitive. Populators count phases by these numbers (phase-density, first-snowfall-phase), and the sub-seasons value of block replacements accepts them too.

How the phase is chosen

The phase follows the world's progress through its season: the in-game time since its <id>-start date in calendar.yml, divided by the season's length (the days from that date to the start of the next season in season-cycle). The phase belongs to the world, so every player there sees the same one. A phase change sends the chunks around players again, slowly, see Chunk refresh.

Thresholds

sub-season-thresholds in a season file sets where START, EARLY, MIDDLE and LATE end, see Season Options. Two equal values remove the phase between them:

sub-season-thresholds:
  start-end: 0
  early-end: 0
  middle-end: 100
  late-end: 100

The season stays in MIDDLE from start to end.

Biome colours

Outside MIDDLE the colours blend with the neighbouring season in season-cycle:

Phase	Colours shown
`START`	55 percent this season, 45 percent the previous one
`EARLY`	75 percent this season, 25 percent the previous one
`MIDDLE`	This season only
`LATE`	75 percent this season, 25 percent the next one
`END`	55 percent this season, 45 percent the next one

All six colours of the biome files blend, except those the season leaves as NONE. Where the neighbour has no colour for the biome, the biome's vanilla colour takes its place.
The neighbours are the seasons around the one named after the colour set (fall for the fall set) in season-cycle, whichever season shows the set. A neighbour not named spring, summer, fall or winter counts as vanilla colours, and a set whose season is missing from season-cycle does not blend.
Environment attributes blend with other percentages, see Environment attributes.
The blends are built at startup, so changes to biome colours, season-cycle or foliage-transitions need a restart.

Foliage transitions

foliage-transitions in a season file tints the leaves of biomes with a treecolor for the season, on top of the neighbour blend: from-previous in START and EARLY, to-next in LATE and END. The format is on Season Options.

foliage-transitions:
  from-previous: NONE
  to-next: '#32CD32,WEIGHT:0.3'

The shipped spring: leaves take on 30 percent lime green in LATE and END.

Transitions only work in the seasons spring, summer, fall and winter.

Populators, block replacements and weather

Populator rules follow the phase through phase-multipliers, phase-density and first-snowfall-phase, see How often.
Each block replacement lists its phases in sub-seasons on one line, as names or numbers (START, EARLY or 0, 1).
In a season's atmosphere block, a keyframe named after a phase sits in the middle of that phase (at 4.5, 13.5, 51, 88 and 96 percent with the default thresholds), see value forms.

Phases in skills

Name	Value
subseason condition	Aliases `seasonphase` and `phase`. Its attribute `phase` or `p` takes phase names, not numbers: `subseason{phase=START,EARLY}`.
seasonprogress condition	Checks the progress against a range.
`<mythicseasons.subseason>`, `%ms_sub_season%`	The phase name in capitals, like `MIDDLE`. PlaceholderAPI answers `none` in a world without a season.
`<mythicseasons.progress>`, `%ms_progress%`	The season progress as a whole percentage, 0 to 100.

More on Placeholders and PlaceholderAPI.

Turning phases off

sub-seasons.enabled: false in config.yml keeps every world in MIDDLE.

The subseason condition then never matches, not even for MIDDLE, although the placeholders say MIDDLE. Use the season condition for skills that must work either way.
With the calendar off, the phase stops following the date and a world is in MIDDLE after a start. Only a season change gives a world with a saved date the phase of that date.

Core Plugins