Options

temperature.yml in plugins/MythicSeasons/ sets the air temperature, how fast a player's temperature follows it, how long a drink lasts and the units. Everything else is a pack skill, see Temperature.

  • Numbers are in Celsius.
  • /ms reload applies changes. The pack reloads with /mm reload.
  • A deleted key comes back with its shipped value.
  • A YAML error turns temperature off until you fix the file and reload.

General

Option Default What it does
enabled true Master switch. With false, nothing updates and the temperature conditions never match.
temperature-update-interval 40 Ticks between updates (20 ticks = 1 second).
temperature-change-rate 0.2 Share of the gap to the target closed on each update. 1.0 jumps at once.
hydration-seconds 300 How long one drink (any potion, water bottles included) keeps a player hydrated. Dying or leaving ends it.

A world that got its first season while enabled was false needs /ms temperature toggle <world> once you turn it on.

Season base temperature

Each world picks a random base temperature between its season's min-temp and max-temp when the season starts, every new day and at server start. Weather and time of day are added within that range, biome and altitude on top.

Option Default What it does
modifiers.season-base-temperature.<season>.min-temp winter -12, spring 0, summer 20, fall 5 Lowest base temperature, whole degrees. <season> is the season id in lowercase.
modifiers.season-base-temperature.<season>.max-temp winter 0, spring 20, summer 40, fall 20 Highest base temperature.

A season without a block uses the spring values (the console names it), so give every custom season its own block.

Weather and time of day

Option Default What it does
modifiers.weather.rain -4 Whole degrees added while it rains in the world.
modifiers.weather.storm -5 Added instead while it thunders.
modifiers.time-of-day.enabled true Turns the time-of-day curve on.
modifiers.time-of-day.keypoints.<tick> 0: -4, 6000: 3, 12000: 3, 13800: -2, 14800: -5, 22500: -5 Degrees at world time <tick> (0 sunrise, 6000 noon, 12000 sunset, 18000 midnight), in a straight line between points.

The weather values read the world's own weather, not the atmosphere simulation.

Height

The reference altitude is temperature-height-base-level in config.yml, 64 by default.

Option Default What it does
modifiers.height.enabled true Turns the altitude change on.
modifiers.height.per-block 0.08 Degrees taken off per block above the reference.
modifiers.height.cold-season-per-block 0.1 Degrees added per block below the reference, in place of per-block, in seasons with prevent-moisture-change: true (shipped: winter).
modifiers.height.overwrites.<world>.per-block 0.02 for example-world Replaces per-block for one world (exact name), except in seasons with prevent-moisture-change: true.

Other dimensions

Option Default What it does
modifiers.other-dimensions.nether 25 Fixed air temperature in the Nether.
modifiers.other-dimensions.end 0 Fixed air temperature in the End.

These worlds have no season, so the pack skills do not run there. Turn temperature on there with /ms temperature toggle <world>.

Display

Option Default What it does
display.convert-to-fahrenheit false The unit players start with. /togglefahrenheit flips it per player.
display.ip-location-temp-type false Picks a new player's unit from the country of their IP address, which is sent to ip-api.com over plain HTTP.
display.temperature.fahrenheit °F Unit after a Fahrenheit number.
display.temperature.celcius °C Unit after a Celsius number (the key is spelled celcius).

The readout, its colours and the warnings are pack skills, see Display.

Moved to the pack

Older versions read these keys. Delete them: skills in plugins/MythicMobs/packs/MythicSeasons/skills/ do their jobs now, see Updating to the temperature skills.

Old key Now File
modifiers.armor and leather-temperature-cap MS_ArmorWarmth, one modifytemp line per piece, leather with limit=25 TemperatureModifiers.yml
modifiers.block-effects MS_BlockHeat, one blockheat line per kind of block BlockHeat.yml
modifiers.touching-water, and water-temperature in biome files MS_Wetness, values by season id TemperatureModifiers.yml
modifiers.foods-and-drinks.water-bottle and full-hunger-bar MS_FoodAndDrink, both with limit=25 TemperatureModifiers.yml
modifiers.foods-and-drinks.water-bottle-effect-duration hydration-seconds in this file temperature.yml
modifiers.foods-and-drinks.hydration-buff A potion line with ?ishydrated in your own skill. No buff ships
modifiers.max-sprinting-modifier MS_SprintWarmth TemperatureModifiers.yml
modifiers.velocity-per-ms MS_WindChill, steps by speed TemperatureModifiers.yml
modifiers.lava-temperature The lava line of MS_TemperatureReadout, <mythicseasons.bodytemperature.1200> TemperatureReadout.yml
custom.items MS_HeldItems and the lines of MS_ArmorWarmth, see Custom Items TemperatureModifiers.yml
effects.cold, effects.warm The conditions of the effect skills, MS_TemperatureRecovery, and the readout colours and warnings Temperature.yml, TemperatureReadout.yml
effects.boosts MS_Boosts (Regeneration from 15 to 25) Temperature.yml
effects.reduce-movement-speed MS_TemperatureSlowdown, Slowness tiers in place of a slower walk. No season lists it Temperature.yml
display.temperature.actionbar, actionbar-display, overwrite-actionbar, actionbar-yield-seconds MS_TemperatureReadout. Take it out of skill-triggers to hide the readout. It does not wait for other plugins TemperatureReadout.yml
display.warnings MS_TemperatureWarnings and the warning text of MS_TemperatureReadout TemperatureReadout.yml

%ms_temperaturecolor% and %ms_air_temperaturecolor% were removed. The readout colour is the MythicMobs variable caster.mstempcolor, which other plugins can show as %mythic_var_mstempcolor%.

File Key Default What it does
config.yml temperature-height-base-level 64 Reference altitude of modifiers.height.
config.yml temperature-modify-command.min, .max -999999, 999999 Limits on the sum of a player's timed changes from /ms temperature modify.
config.yml performance.chunk-supplier-interval 20 Ticks between scans for the blockheat lines. Restart to apply.
config.yml performance.skill-trigger-interval 5 Ticks between runs of the season skills, the temperature skills included. Restart to apply.
seasons/<id>.yml prevent-moisture-change false (shipped winter: true) Switches altitude to cold-season-per-block.
seasons/<id>.yml skill-triggers.player-tick per season Lists the pack skills for modifiers, effects and the readout.
biome files temperature-difference per biome Whole degrees the biome adds. A file with includes: ALL ignores it. Restart to apply.
griefprevention.yml claimed-areas.fixed-temperature.enabled, .value false, 25 A fixed body temperature inside claims. Restart to apply.

WorldGuard regions take the flags permanent-temperature (a fixed body temperature) and temperature-modifier (degrees added), both whole numbers. See General, Season Options, Biomes and Land Claims.

Examples

modifiers:
  season-base-temperature:
    winter:
      min-temp: -25
      max-temp: -5

Winter base temperatures fall between -25 and -5.

MS_BlockHeat:
  Skills:
  - blockheat{blocks=campfire[lit=true];amount=15;range=7;air=true} @Self
  - blockheat{blocks=furnace[lit=true];amount=10;range=5} @Self

In the pack's skills/BlockHeat.yml: only lit campfires and lit furnaces warm players. Run /mm reload.

Updated Nov 11, 2026