# Seasons

The **Seasons** feature in the InfiniteCrops plugin introduces dynamic seasonal changes, affecting gameplay elements like temperature and water loss. Each season has its own duration, attributes, and world-specific configurations. This guide explains how to configure the `seasons.yml` file and understand how seasons work.

***

#### **File Structure**

The `seasons.yml` file is structured to define attributes for each season, such as:

1. **Duration**: The time each season lasts, randomized between a minimum and maximum.
2. **Temperature**: Seasonal temperature impacts crop growth and water retention.
3. **Worlds**: Specifies the worlds where the season is active.
4. **Water Loss**: Defines how much water crops lose during the season.

***

#### **Configuration Example**

```yaml
seasons:
  spring:
    duration_min: 140
    duration_max: 300
    name: spring
    id: infinitecrops_spring
    temperature: 7.0
    worlds:
    - world
    water_loss: 1.0
  summer:
    duration_min: 140
    duration_max: 320
    name: summer
    id: infinitecrops_summer
    temperature: 15.0
    worlds:
    - world
    water_loss: 1.8
  autumn:
    duration_min: 100
    duration_max: 240
    name: autumn
    id: infinitecrops_autumn
    temperature: 0.0
    worlds:
    - world
    water_loss: 0.5
  winter:
    duration_min: 200
    duration_max: 320
    name: winter
    id: infinitecrops_winter
    temperature: 0.0
    worlds:
    - world
    water_loss: 0.0
```

***

#### **Key Sections**

**1. General Attributes**

* **`duration_min` and `duration_max`**:
  * Define the range (in minutes) for how long the season will last.
  * Example:

    ```yaml
    codeduration_min: 140
    duration_max: 300
    ```

    * The season will last between 140 and 300 minutes.
* **`name`**:
  * The display name of the season.
  * Example: `spring`
* **`id`**:
  * A unique identifier for the season.
  * Example: `infinitecrops_spring`
* **`temperature`**:
  * The temperature during the season. This value can influence crop behavior and growth.
  * Example: `7.0`
* **`worlds`**:
  * The list of worlds where the season is active.
  * Example:

    ```yaml
    codeworlds:
    - world
    ```
* **`water_loss`**:
  * The rate at which crops lose water during the season.
  * Example: `1.8`

***

#### **Season Mechanics**

1. **Season Duration**:
   * Seasons last a random amount of time between `duration_min` and `duration_max`.
2. **Dynamic Transitions**:
   * When a season ends, the plugin automatically transitions to the next season in the cycle.
3. **World-Specific Seasons**:
   * Different worlds can have independent seasonal cycles by listing them in the `worlds` attribute.
4. **Temperature Effects**:
   * Temperature can be used to simulate realistic crop growth conditions, where some crops thrive in warmer seasons and others in cooler ones.
5. **Water Loss**:
   * Defines how quickly crops dry out in a season. Higher values mean crops need to be watered more frequently.

***

#### **Customizing Seasons**

**Adding a New Season**

1. Define a new entry under `seasons`.
2. Provide unique values for `name`, `id`, `duration_min`, `duration_max`, `temperature`, and `water_loss`.
3. Specify the worlds where the new season applies.

Example:

```yaml
seasons:
  rainy:
    duration_min: 150
    duration_max: 300
    name: rainy
    id: infinitecrops_rainy
    temperature: 10.0
    worlds:
    - rainy_world
    water_loss: 0.8
```

**Adjusting Season Order**

The order of seasons is determined by the plugin and follows the sequence defined in the configuration. Adjust the order by reordering entries in the YAML file.

***

#### **Practical Example**

Let’s say you want **summer** to have higher water loss and last longer than **spring**. Update the configuration like this:

```yaml
summer:
  duration_min: 200
  duration_max: 400
  name: summer
  id: infinitecrops_summer
  temperature: 20.0
  worlds:
  - world
  water_loss: 2.5
```

***

#### **Troubleshooting**

* **Season Does Not Apply in a World**:
  * Ensure the world is listed under the `worlds` attribute for the season.
* **Random Duration Is Not Working**:
  * Verify `duration_min` and `duration_max` are set correctly and are integers.
* **Crops Not Behaving Correctly**:
  * Check that the `temperature` and `water_loss` values are appropriately configured for the season.


---

# 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://pm2plugins.gitbook.io/infinitecrops/features/seasons.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.