Your First Season

Create your own season, a monsoon between summer and fall, and switch a world to it. The guide has eight steps.

What you need

• MythicSeasons installed and started once, and the mythicseasons.admin permission (operators have it). See Installation.
• An overworld-type world. The Nether and the End cannot have seasons.
• The shipped calendar.yml, config.yml and temperature.yml, unchanged. The guide's dates and order fit them.

Paths are relative to plugins/MythicSeasons.

Step 1: Copy the example file

Copy seasons/example.yml to seasons/monsoon.yml. The id inside names the season, not the file name.

Step 2: Edit the copy

Replace the content of seasons/monsoon.yml with this:

enabled: true
id: monsoon
display-name: "<#2E8B57>Monsoon"
transition-message: "<green>The monsoon rains have arrived."
weather:
  daily-extra-downfall-chance: 50%
  has-natural-downfall: true
biome-color-key: summer
biome-color-index: -1
skill-triggers:
  player-tick:
    - MS_Atmosphere
    - MS_ColdHunger
    - MS_ColdSlowness
    - MS_ColdFreezing
    - MS_HeatNoHealing
    - MS_HeatSlowness
    - MS_HeatFire
    - MS_BlockHeat
    - MS_TemperatureRecovery
    - MS_TemperatureModifiers
    - MS_TemperatureReadout
    - MS_TemperatureWarnings

• id is the lowercase name that /ms set, season-cycle and calendar.yml use.
• Players get transition-message when the world changes to the season, while send-message-on-season-cycle in config.yml is true (the default). Only the four shipped seasons have a language key (SEASON-TO-WINTER, SEASON-TO-SPRING, SEASON-TO-SUMMER and SEASON-TO-FALL in lang/en.yml), so a new season without transition-message sends nothing.
• weather allows vanilla rain. In worlds without the weather simulation it also tries to start an extra rain at random, at 50 percent about once every two in-game days, but never while it rains or during the clear-weather pause after a rain (clear-weather-min-duration to clear-weather-max-duration in config.yml).
• biome-color-key only picks the group /ms biomelist lists the season in.
• biome-color-index: -1 keeps the vanilla biome colours. Only four colour sets exist, filled by the files in biomes/: 0 (winter), 1 (summer), 2 (spring) and 3 (fall). Two seasons that share a number overwrite each other's blocks, so only one custom season should use -1. With -1 the vanilla clouds draw next to the volumetric ones, see Setting Up Clouds.
• The player-tick list holds the same pack skills as the shipped seasons. They need MythicMobs.
• Without an atmosphere.cloud-layers.cumulus block the season draws more cloud than the shipped spring, summer and fall, and lower (no lift). Copy the block from a shipped season to match them.

Do not reload yet: steps 3 to 5 change three more files.

Step 3: Add the start date

Add this line to calendar.yml, next to winter-start, spring-start, summer-start and fall-start:

monsoon-start: July 10

The key is the season id plus -start. The value is a month name, a space and a day, and the month name must match the months list of the same file exactly, capitals included.

Step 4: Add the season to the cycle

Replace the season-cycle list in config.yml:

season-cycle:
  - spring
  - summer
  - monsoon
  - fall
  - winter

Step 5: Give the season a temperature range

Add a monsoon block under modifiers.season-base-temperature in temperature.yml, below fall, and keep the four blocks already there:

modifiers:
  season-base-temperature:
    monsoon:
      min-temp: 22
      max-temp: 34

The range is in degrees Celsius. Without the block the season uses the spring range.

Step 6: Reload

Run:

/ms reload

Chat shows two lines, the second one after every reload:

Reloaded
Biome file changes need a restart

The console lists every season it loads, including:

Loaded season: monsoon

The reload also adds a monsoon block to every crop in crops.yml, at vanilla growth speed (1.0).

Check the console for warnings that name monsoon:

Step 7: Switch a world to the season

Stand in the world and run:

/ms set monsoon

From the console add the world: ms set monsoon <world>. Everyone in the world gets The monsoon rains have arrived., and you see:

Season set to Monsoon

With the calendar and sub-seasons on, as shipped, the world's date also moves to the halfway day of the season. Unknown season, pick one of: <ids> means the season is not loaded, see step 6.

Step 8: Confirm with /ms getinfo

Run:

/ms getinfo

On a fresh install the first lines read:

Season: Monsoon
Date: Wednesday, August 7, year 0
Days until Fall: 28

The date moves on with the in-game day. From the console run ms getinfo <world>. Run it again a few seconds later: the season is still Monsoon.

Next steps

• Seasons, Season Options, Populators, Biomes and Calendar cover how seasons work, season files, blocks, colours and dates.
• Your First Event and Seasonal Skills With MythicMobs are the next guides.
• Seasons Not Changing has the checks when a season does not change.