Custom Climate Profile

Give one world its own climate with an atmosphere profile: a hot, dry, windy sky with a dust haze, modelled on the shipped mars profile. The guide has five steps.

What you need

• The weather simulation running in the world (it has its own line in /ms atmosphere info), see Setting Up Weather.
• For the cloud layers only, the clouds switched on, see Setting Up Clouds.
• The mythicseasons.admin permission (operators have it).
• The name of the world. The examples use resource_world.

Paths are relative to plugins/MythicSeasons.

Step 1: Read the model

A profile is a YAML file in atmosphere-profiles with the settings of a season file's atmosphere: block, and it changes only the settings it names. The shipped mars.yml without its comments:

temperature: -60
humidity: 0.0
forcing:
  wind:
    speed-base: 9.0
physics:
  auto-rate: 0.0
clouds:
  layers: [mars-dust, mars-ice]
  tint: "FFFFFF"

Step 2: Create your profile file

Copy atmosphere-profiles/mars.yml to atmosphere-profiles/dust-bowl.yml and replace its content with this:

temperature: 15
humidity: 0.25
forcing:
  wind:
    speed-base: 9.0
clouds:
  layers: [cumulus, mars-dust]

• temperature: 15 makes the surface 15 degrees Celsius warmer than the biome's own climate, in every season. A plain number replaces what the seasons add. To add 15 on top of the seasons instead, write the value in quotes with the operator: "+15". An unquoted +15 is a plain number.
• humidity: 0.25 multiplies the moisture the ground gives the air by 0.25, so less cloud and rain form.
• forcing.wind.speed-base: 9.0 makes the ground wind stronger than the default 4.0.
• clouds.layers replaces the list from every earlier place, such as atmosphere.yml. Keep cumulus first, so it stays the solid layer players can be inside. mars-dust is a see-through orange haze that shows only where the ground wind is above 3 metres per second, thickest from 7. [] draws no clouds, and a string such as "cumulus, mars-dust" is read as one name that matches no file.

The profile's name is the file name without .yml, in lower case: dust-bowl. Use letters, digits, - and _.

Step 3: Apply the profile to the world

In atmosphere.yml, replace the shipped line worlds: {} with:

worlds:
  resource_world:
    profile: dust-bowl

The key is the world name, in any letter case. The profile applies in every season. Only a season file's atmosphere.worlds.<world> block and profiles that skills push win over it. An entry under worlds does not switch the world on.

Step 4: Reload

Run:

/ms reload

Chat shows Reloaded and Biome file changes need a restart (the second line after every reload). The air moves toward the new climate over time.

This console line means the world names a profile that is not loaded:

atmosphere.yml worlds.resource_world.profile: there is no atmosphere-profiles/dust-bowl.yml

Check the spelling, and that the file sets at least one known setting: a file with only comments or unknown keys is not loaded as a profile.

Step 5: Verify

List the loaded profiles:

/ms atmosphere profiles

dust-bowl is one of them, in no fixed order:

Atmosphere profiles
- dust-bowl
- example
- mars
Use one with atmosphere.profile: [name] or the atmosphereprofile mechanic

Then read what applies to your world (from the console the world name is required):

/ms atmosphere profile resource_world

It starts like this, with the season of the current date:

Profile resource_world (summer 42%)
Forced: dust-bowl

Among the lines that follow are your three settings, each with its source:

  temperature 15 (profile dust-bowl)
  humidity 0.25 (profile dust-bowl)
  forcing.wind.speed-base 9 (profile dust-bowl)

Near the end, each cloud layer gets a block that starts with a header:

Layer cumulus (solid)
Layer mars-dust (see-through 0.4)

Good to know

• A change to a profile file needs /ms reload. A profile that a skill pushed with the atmosphereprofile mechanic keeps the content it had when the skill ran.
• profile: mars makes a world a copy of Mars, with dust particles from the pack skill MS_MarsDust.

Next steps

• Profiles and Overrides cover profiles in depth. Season Adjustments, Weather, Forcing and Physics list the settings a profile can change.
• Custom Cloud Layer writes a layer for clouds.layers, and AtmosphereProfile tests which profile a world has.