Config

Every file and folder MythicSeasons uses, and the page that documents it. The plugin folder is plugins/MythicSeasons/.

Files in the plugin folder

File or folder What it holds Documented in Notes
config.yml Plugin-wide switches, season order, block replacements, new worlds General
lang/ Language files. en.yml ships Language
griefprevention.yml How GriefPrevention claims affect seasons Land claims Created only when GriefPrevention is installed.
commands.yml Command names, aliases and which commands are on Commands and Permissions A missing key takes the bundled value.
calendar.yml Months, season start dates, clock format, synced worlds Calendar
seasons/ One file per season: winter.yml, spring.yml, summer.yml, fall.yml and example.yml Seasons, Season options example.yml ships disabled (enabled: false). Every other .yml file you add is loaded as a season.
biomes/ Biome colour files: 20 group files, CUSTOM_EXAMPLE.yml and your own Biomes CUSTOM_EXAMPLE.yml is an example but ships active (includes: ALL).
events/ One file per event: christmas.yml, newyear.yml, halloween.yml, easter.yml and example.yml Events, Event options example.yml ships disabled. Files named events.yml or custom-events.yml are ignored.
crops.yml Crop growth speed per season Crops
temperature.yml The body temperature system Temperature options
atmosphere.yml The weather simulation and clouds, on by default Atmosphere options
cloud-layers/ One file per cloud layer: cumulus.yml, ground-fog.yml, cirrus.yml, cirrus-hooks.yml, cirrostratus.yml, fog-banks.yml, mars-dust.yml and mars-ice.yml Cloud layers, Built-in layers Every other .yml file you add is read as a layer.
cloud-styles/ One file per cloud look: soft.yml, billowy.yml, toon.yml and wisp.yml Styles A layer picks one with style. No shipped layer does.
atmosphere-profiles/ Named weather profiles: example.yml and mars.yml Profiles example.yml does nothing until a world, season or mechanic names it.
data.yml Each world's season, date and switches, and each player's toggles, temperature effects and settings none Written by the plugin. Do not edit it.
MythicSeasons-CloudFog.zip The cloud fog resource pack Shader pack Written while the atmosphere and clouds.shader-pack.enabled are on, named after clouds.shader-pack.name. Do not edit it.
debug/ Dump files of /ms atmosphere dumpclouds Debugging

data.yml is saved every performance.autosave-interval-minutes minutes and when the server stops.

Files outside the plugin folder

Location What it holds Documented in Notes
plugins/MythicMobs/packs/MythicSeasons/ The bundled MythicMobs pack: packinfo.yml and the skill files Ambient.yml, Atmosphere.yml, AtmosphereSeasons.yml, BlockHeat.yml, Temperature.yml, TemperatureModifiers.yml and TemperatureReadout.yml in skills/ Packs Installed when MythicMobs is present. Existing files are never overwritten.
<world folder>/mythicseasons/ The saved weather of that world Atmosphere Written by the plugin. Do not edit it.

How files are created and kept current

  • Missing files are created from the plugin's copies, so a deleted shipped file comes back at the next start.
  • config.yml, temperature.yml and atmosphere.yml get missing keys added at each start and reload.
  • calendar.yml and crops.yml get missing newer entries added, lang/en.yml missing keys. Your values are kept.
  • Season, event, biome, cloud layer, cloud style and profile files are never changed, except that a biome file without temperature-difference gets that key written.

Reloading

/ms reload re-reads config.yml, lang/, seasons/, calendar.yml, events/, crops.yml, temperature.yml, atmosphere.yml, cloud-layers/, cloud-styles/ and atmosphere-profiles/, and applies the populators and block replacements again. /ms debug toggles verbose logging and reloads the files too.

These need a restart:

  • biomes/, except the atmosphere section of a biome file.
  • griefprevention.yml and commands.yml.
  • The shader part of a cloud style.
  • Which season's colours blend into which (the neighbours in season-cycle), and the foliage-transitions of season files.
  • Some config.yml options, see Reloading.
  • Atmosphere settings the console names when you reload.

After editing the MythicMobs pack, run /mm reload. /ms reload never touches it.

A reload stops at an error it cannot recover from, and the console shows the error. An unreadable config.yml stops it before anything is reloaded.

Updated Nov 11, 2026