> For the complete documentation index, see [llms.txt](https://docs.samscreations.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samscreations.eu/samsseasons/home.md).

# Home

Welcome to the SamsSeasons documentation!

## SamsSeasons 

SamsSeasons brings **Spring, Summer, Autumn and Winter** to your Minecraft server. The land really changes with the seasons: leaves turn gold and fall, snow settles and melts away, cherry blossoms bloom on the oaks, winter nights grow long, and players feel the cold.

{% hint style="success" %}

#### **Works out of the box!**

Drop the jar in, start the server, and the seasons run. No datapack to install, no restart needed for the seasonal colours, and every feature can be tuned or switched off. 🍂
{% endhint %}

***

### Compatibility

{% tabs %}
{% tab title="Software" %}

* **Java:** 21+
* **Server Version:** 1.21+
* **Supported Software:** Paper (and forks like Purpur)
* **Folia:** not supported
  {% endtab %}

{% tab title="Integrations" %}

* **PacketEvents** seasonal grass, leaf and water colours (recommended)
* **ItemsAdder / Nexo** automatic resource-pack merging
* **WorldGuard** region flags for temperature, particles, snow, crops and mobs
* **PlaceholderAPI** season, date, weather, festival and temperature placeholders
* **Multiverse** seasons in every world, one shared calendar
* **BlueMap / Dynmap** seasonal snow stays off your web map
* **MySQL** one calendar for a whole network
  {% endtab %}
  {% endtabs %}

***

### Key Features

{% columns %}
{% column %}
{% hint style="info" icon="flower-tulip" %}

#### **Real Seasonal Colours**

Grass, leaves, water and sky follow the season and blend smoothly from one to the next.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="success" icon="snowflake" %}

## **Snow & Ice That Comes and Goes**

Snow settles on the land and water freezes in winter, then thaws in spring.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% hint style="warning" icon="wand-magic-sparkles" %}

## **Seasonal Particles**

Falling leaves in the season's colours, snowflakes and fireflies, sent to players who can see them.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="danger" icon="cloud" %}

## **Weather & Sky**

Rainy autumns, snowy winters, a real forecast, long winter nights, shooting stars and the aurora.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

***

### Navigation

{% content-ref url="/pages/uDiPlPyoxZPQiYzrebQz" %}
[GUIDES](/samsseasons/guides/getting-started.md)
{% endcontent-ref %}

{% content-ref url="/pages/FQiuZbBFd6eeTaUpBXx6" %}
[SEASONS](/samsseasons/seasons/what-is-it.md)
{% endcontent-ref %}

{% content-ref url="/pages/BrnJO5OHs6bugZuhMher" %}
[ADDONS](/samsseasons/addons/what-is-an-addon.md)
{% endcontent-ref %}

{% content-ref url="/pages/Guc8woAjuANK7nHn8dPn" %}
[INTEGRATIONS](/samsseasons/integrations/itemsadder-and-nexo.md)
{% endcontent-ref %}

{% content-ref url="/pages/IpmCc3dHm0IoQwZv1i5p" %}
[DEVELOPERS](/samsseasons/developers/developer-api.md)
{% endcontent-ref %}

***

{% hint style="info" %}

#### Support me!

If you enjoy using SamsWheel, feel free to [Buy me a coffee](https://ko-fi.com/sam1qk)! Thank you! 🧡
{% endhint %}