# Gregorian Calendar

### &#x20;*<mark style="color:yellow;">Soon to be added to AdvancedSeasons!</mark>*

In the upcoming release of AdvancedSeasons, a new **Gregorian Calendar** feature will be available, providing an option to choose between **CUSTOM** and **GREGORIAN** calendar types for your Minecraft world. Here's what each calendar type offers:

* **GREGORIAN Calendar**: This type follows the traditional 365-day format, allowing you to define when each season starts within the calendar year. It provides a more realistic simulation of real-world seasons but restricts any modification of the total number of days in a year.
* **CUSTOM Calendar**: This option gives you full flexibility to determine the total number of days based on the sum of the **seasonDays** and **transitionDays** (typically covering four seasons). It allows for custom configurations suited for game mechanics.

{% code title="calendars.yml" lineNumbers="true" fullWidth="true" %}

```yaml
# You can choose CUSTOM or GREGORIAN calendar type.
# GREGORIAN calendar type forces you to have 365 days but allows you to specify a season start
# at a specified date in a 365-day calendar.
# CUSTOM calendar type determines the year days based on the sum of the seasonDays and its transitionDays (full season days * 4).
type: CUSTOM

# This doesn't have an effect with GREGORIAN calendars.
season-order: [SPRING, SUMMER, FALL, WINTER]

# This doesn't have an effect with GREGORIAN calendars.
month-starts:
  january: 1
  february: 2
  march: 3
  april: 4
  may: 5
  june: 6
  july: 7
  august: 8
  september: 9
  october: 10
  november: 11
  december: 12

# Now you can configure day lengths > 20 minutes!
time:
  dayLength: 20
  # 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

# Maximum combined length of seasonDays and transitionDays cannot be less than 3!
calendar:
  # This value only works for CUSTOM calendar types
  # How many days should one season last
  seasonDays: 2
  # How many days should it take to phase between seasons?
  transitionDays: 1

# This only works with GREGORIAN calendars.
# You must introduce the date when the seasons start in the following format: dd-MM
# Default values are based on the north hemisphere.
season-start-dates:
  spring: 20-03 # March 20th
  summer: 20-06 # June 20th
  fall: 22-09 # September 22nd
  winter: 21-12 # December 21st
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://seasons.advancedplugins.net/features/calendar/gregorian-calendar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.