Wikis / MythicSeasons / Config / General

General

config.yml in plugins/MythicSeasons/ holds the plugin-wide switches. A deleted option comes back with its default at every start and /ms reload.

General

Option Default What it does
language en Language file in the lang folder, without .yml (see Language). A name with no file falls back to English with a warning.

Season cycle

Option Default What it does
automatic-season-cycling true Moves each world to the next season on that season's start date in the calendar. With false, only /ms set and /ms nextseason change seasons.
season-cycle spring, summer, fall, winter Season order by id (not case-sensitive). Each listed season needs a <id>-start date in calendar.yml. Unknown ids are dropped with a warning, and with no valid id every loaded season is used in load order.
send-message-on-season-cycle true Sends the new season's transition-message to the world when its season changes. If it is empty, the four shipped seasons use their language line SEASON-TO-<ID>.
sub-seasons.enabled true Splits each season into the phases START, EARLY, MIDDLE, LATE and END (see Sub-Seasons). With false, every world stays in MIDDLE, colours do not blend and the subseason condition never matches.

The order also sets which season's colours blend into which. That part needs a restart.

World and client changes

Option Default What it does
modify-blocks true In worlds with a season, stops ice and snow forming naturally in biomes with freeze-in-winter: true, keeps grass under snow from turning to dirt, and applies prevent-moisture-change to farmland under open sky.
keep-natural-snow true While modify-blocks is on, still lets ice and snow form where vanilla snow would (block temperature below 0.15).
modify-biome-on-client true Rewrites the chunks sent to players with the seasonal biome colours, block replacements and populators. The world itself is not changed.
modify-daynight-length true Runs day and night at the current month's lengths from calendar.yml, with the daylight cycle game rule off in worlds with a season.
modify-weather-cycle true Applies has-natural-downfall, prevent-thunder and daily-extra-downfall-chance from the season files, and starts a dry spell whenever rain ends.
disable-berry-damage-for-entities true Sweet berry bushes only hurt players.
pause-map-plugins-render-in-winter false Pauses Dynmap or BlueMap rendering in a world while its season has pause-map-render: true (shipped: winter).
  • Populator snow and ice do not depend on modify-blocks.
  • With modify-daynight-length on and sync-time-with-real-world off in calendar.yml, enough sleeping players skip the night and start a dry spell.
  • Setting modify-daynight-length to false does not turn the daylight cycle game rule back on. Use /gamerule or /ms pausetime in those worlds.
  • The extra rain needs has-natural-downfall: true, starts only in dry weather outside a dry spell, and never starts where the atmosphere runs.
  • With both Dynmap and BlueMap installed, only Dynmap is used. It pauses its update renders while any world is paused.

Weather durations

Each dry spell (clear weather) and extra rain lasts a random time between its shortest and longest value, in ticks (20 ticks = 1 second, whole numbers from 0 up). A maximum below its minimum is raised to it, with a warning.

Option Default What it does
clear-weather-min-duration 12000 (10 min) Shortest dry spell.
clear-weather-max-duration 168000 (140 min) Longest dry spell.
rain-min-duration 12000 (10 min) Shortest rain started from a season's daily-extra-downfall-chance. Vanilla rain is not affected.
rain-max-duration 24000 (20 min) Longest such rain.

Biomes

Both options need a restart.

Option Default What it does
optimized-custom-biomes true Registers one biome per distinct look instead of one per biome file, season and colour. Keep it on unless you need every biome registered separately.
biome-display-name mythicseasons Namespace of the plugin's biomes, as in mythicseasons:spring_forest, turned into lowercase. An empty value keeps the old name, with a warning.

Block replacements

Block replacements show players one block type as another in chosen seasons and phases. The world keeps its real blocks, and the shown block takes its default state. Needs modify-biome-on-client. For more than a swap, use a season's populators.

block-replacements:
  enabled: true
  replacements:
    pink-trees:
      enabled: true
      to-replace: OAK_LEAVES
      replacement: CHERRY_LEAVES
      seasons: SPRING
      sub-seasons: 2

Oak leaves show as cherry leaves in the MIDDLE phase of spring.

Option What it does
block-replacements.enabled Master switch for every entry. Default true.
replacements.<name>.enabled Turns one entry on (<name> is any name). Anything but true counts as off.
replacements.<name>.to-replace The block to find, as an uppercase Bukkit material name.
replacements.<name>.replacement The block players see instead.
replacements.<name>.seasons Season ids, comma-separated on one line (not a YAML list), matched through each season's biome-color-index.
replacements.<name>.sub-seasons Phases, comma-separated: START, EARLY, MIDDLE, LATE, END or the numbers 0 to 4, mixed as you like.
  • An unknown material, season id or phase, or an empty seasons, skips the whole entry with a console message.
  • A block type takes one replacement. When two enabled entries share a to-replace, the earlier one never applies, even in its own seasons, so list every season and phase in one entry.
  • With sub-seasons.enabled: false, only entries that list MIDDLE or 2 apply.
  • Deleted shipped entries come back. Set enabled: false instead.

Temperature

Option Default What it does
temperature-height-base-level 64 The Y level that modifiers.height in temperature.yml counts from.
temperature-modify-command.min -999999 Lowest total of a player's timed changes from /ms temperature modify and the API, before the pack's skill modifiers are added.
temperature-modify-command.max 999999 Highest total of those changes.

The limits do not check the number typed in the command, and do not apply to the FIXED(...) form or the modifytemp mechanic.

New worlds

Option Default What it does
on-new-world-creation.sync-with-other-worlds false Adds new worlds to synced-worlds in calendar.yml, with the calendar's season for today.
on-new-world-creation.default-season NONE Season id (not case-sensitive) for a world without one, when it is created and at startup. NONE, an empty value or an unknown id (logged as a warning) gives no season.

Neither option applies to the Nether or the End.

Performance

All three need a restart. The lowest allowed value is 1.

Option Default What it does
performance.chunk-supplier-interval 20 Ticks between scans around players for the blocks of the blockheat lines in skills/BlockHeat.yml. Lower reacts faster and costs more.
performance.skill-trigger-interval 5 Ticks between runs of the season skill triggers (player-tick, player-tick-particles, world-tick and the weather triggers).
performance.autosave-interval-minutes 5 Minutes between saves of data.yml and the saved weather. The plugin also saves when it stops.

Written by the plugin

version is the plugin version that last saved the file. Do not edit it.

Wrong values

  • A switch that is not true or false, or a number that is not whole, logs a warning and uses the default. A number below its minimum is raised to it, with a warning.
  • Not checked: for the block-replacements switches anything but true is off, and for temperature-height-base-level and temperature-modify-command a value that is not a number counts as 0 and decimals are cut.
  • A YAML syntax error keeps the plugin from starting, or makes /ms reload reload nothing. The file is never overwritten while it cannot be read.

Reloading

/ms reload applies everything except optimized-custom-biomes, biome-display-name, the three performance options and the colour blending order of season-cycle, which need a restart.

  • modify-biome-on-client and block-replacements change the chunks sent from then on.
  • pause-map-plugins-render-in-winter takes effect at the next season or sub-season change.
  • on-new-world-creation applies to worlds created afterwards.
  • Turning modify-daynight-length on does not switch the daylight cycle game rule off until the world's season changes or the server restarts. Use /gamerule until then.
Updated Nov 11, 2026