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.ymlandatmosphere.ymlget missing keys added at each start and reload.calendar.ymlandcrops.ymlget missing newer entries added,lang/en.ymlmissing 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-differencegets 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 theatmospheresection of a biome file.griefprevention.ymlandcommands.yml.- The
shaderpart of a cloud style. - Which season's colours blend into which (the neighbours in
season-cycle), and thefoliage-transitionsof season files. - Some
config.ymloptions, 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.