📅Calendar

The Calendar System in AdvancedSeasons introduces a dynamic time progression concept, allowing players to experience the passage of seasons and day-night cycles in a more structured manner. This system is highly customizable, giving server administrators the flexibility to set the length of seasons and transitions to fit their gameplay style.

Configuration File

calendars.yml

# Maximum combined length of day and night cannot exceed 20 minutes

time:
  # In Vanilla: entire day in normal minecraft is 20 minutes
  spring:
    # Length of day time, in real world minutes
    dayLength: 10
    nightLength: 10
  summer:
    dayLength: 15
    nightLength: 5
  fall:
    dayLength: 10
    nightLength: 10
  winter:
    dayLength: 7
    nightLength: 13

# Seasons Progression
progression:
  # Should season progression be paused? Set to true to pause
  paused: false

calendar:
  # How many days should one season last
  seasonDays: 2
  # How many days should it take to transition between seasons?
  transitionDays: 1

Technical Explanation

Time Configuration

• The time section allows for the configuration of day and night lengths for each season, altering the typical 20-minute day cycle of Vanilla Minecraft.

  • spring, summer, fall, winter: Each season has configurable dayLength and nightLength settings, measured in real-world minutes.

    • Spring and Fall: Balanced with equal lengths for day and night.

    • Summer: Longer days and shorter nights.

    • Winter: Shorter days and longer nights.

Season Progression

Set progression.paused to true to disable global season progression. Then, only way to progress a season in worlds is with commands.

Calendar Configuration

• The calendar section configures the overall timeline of seasons in the game.

  • seasonDays: Defines how many days a single season lasts.

  • transitionDays: Sets the number of days it takes to transition between seasons.

  • This setup means each season, along with its transition period, is spread over a specified number of Minecraft days, providing a clear and predictable seasonal cycle.

  • Example Configuration:

    • seasonDays: 2

    • transitionDays: 1

This calendar system not only adds a realistic aspect to the game but also enhances strategic planning for activities like farming, exploring, and building, as players can anticipate and prepare for the changing seasons and varying lengths of day and night.

Calendar Menu Configuration

menus/calendarMenu.yml

name: "&e&lSᴇᴀsᴏɴs Cᴀʟᴇɴᴅᴀʀ"
size: 36

settings:
  eventFormat:
    none: " &7No Events"
    event: " &8- &a%event name%! &7(%time% Time)"
  # Slots in inventory where season days will be displayed
  seasonSlots: 4,5,6,7,8,13,14,15,16,17,22,23,24,25,26,31,32,33,34,35
  # You can name each slot separately, starting from the first slot to the last will auto assign names
  SPRING:
    slots: 12,13,14
    slotNames:
      - 'Mᴀʀᴄʜ'
      - 'Aᴘʀɪʟ'
      - 'Mᴀʏ'
    type: PINK_STAINED_GLASS_PANE
    name: '&d&l%slot name% - &dSᴘʀɪɴɢ Dᴀʏ %day%'
    lore:
      - '&8Month of %slot name%'
      - ''
      - '&f%slot name%''s Eᴠᴇɴᴛs:'
      - '%events%'
  SUMMER:
    slots: 15,16,17
    slotNames:
      - 'Jᴜɴᴇ'
      - 'Jᴜʟʏ'
      - 'Aᴜɢᴜsᴛ'
    type: LIME_STAINED_GLASS_PANE
    name: '&a&l%slot name% - &aSᴜᴍᴍᴇʀ Dᴀʏ %day%'
    lore:
      - '&8Month of %slot name%'
      - ''
      - '&f%slot name%''s Eᴠᴇɴᴛs: '
      - '%events%'
  FALL:
    slots: 21,22,23
    slotNames:
      - 'Sᴇᴘᴛᴇᴍʙᴇʀ'
      - 'Oᴄᴛᴏʙᴇʀ'
      - 'Nᴏᴠᴇᴍʙᴇʀ'
    type: YELLOW_STAINED_GLASS_PANE
    name: '&e&l%slot name% - &eFᴀʟʟ Dᴀʏ %day%'
    lore:
      - '&8Month of %slot name%'
      - ''
      - '&f%slot name%''s Eᴠᴇɴᴛs: '
      - '%events%'
  WINTER:
    slots: 24,25,26
    slotNames:
      - 'Dᴇᴄᴇᴍʙᴇʀ'
      - 'Jᴀɴᴜᴀʀʏ'
      - 'Fᴇʙʀᴜᴀʀʏ'
    type: WHITE_STAINED_GLASS_PANE
    name: '&f&l%slot name% - Wɪɴᴛᴇʀ Dᴀʏ %day%'
    lore:
      - '&8Month of %slot name%'
      - ''
      - '&f%slot name%''s Eᴠᴇɴᴛs:'
      - '%events%'

items:
  filler:
    type: BLACK_STAINED_GLASS_PANE
    name: ' '
  10:
    type: BOOK
    name: '&aSᴇᴀsᴏɴs'
    lore:
      - '&7Depending on the current season, you will notice'
      - '&7changes in the weather, temperature, and day length.'
      - ''
      - '&7- &fSeasonal Weather:'
      - '&7Experience snow in Winter, rain in Fall,'
      - '&7or sunny days in Summer.'
      - '&7- &fTemperature:'
      - '&7Seasons will affect the overall temperature,'
      - '&7causing seasonal effects.'
      - '&7- &fCrops:'
      - '&7Depending on weather, temperature,'
      - '&7and season, they grow quicker or slower.'
      - '&7- &fDay Length:'
      - '&7Days are longer in the Summer and shorter'
      - '&7in the Winter, affecting mobs and crops.'
      - '&7- &fBiome Changes:'
      - '&7Biomes will adapt to seasons, with changes'
      - '&7in grass color, animal behavior, and growth.'