# Madonne Seasons

Change the way weather and time are handled on your FiveM server. **Madonne Seasons** brings a fully dynamic, realistic, and configurable weather and time system — with seasonal cycles, per-zone weather, AI-powered forecasts, and much more.

{% embed url="<https://www.youtube.com/watch?v=geiYTJQoLEo>" %}

***

## 📖 About Madonne Seasons

Madonne Seasons replaces GTA V's default static weather system with a living, breathing environment. Weather evolves dynamically over time, follows realistic transition rules, and varies by geographic zone across the map. Days are longer in summer, shorter in winter, and the sun rises and sets accordingly.

### ✨ Main Features

* 🗓️ **Seasonal Cycle** — Four seasons (Spring, Summer, Autumn, Winter) with configurable real-time duration (days, weeks, months)
* 🌍 **Per-Zone Weather** — The map is divided into 7+ geographic zones, each with its own weather probabilities per season
* ⏱️ **Realistic Time System** — Day/night cycle with variable speed: days are longer or shorter depending on the current season
* ☀️ **Dynamic Sunrise & Sunset** — Sunrise and sunset hours shift throughout the year based on seasonal progression
* 🌤️ **Dynamic Weather Transitions** — Weather changes follow realistic transition rules (e.g. RAIN → THUNDER → CLEARING)
* 📻 **Weather Forecast System** — Players can request tomorrow's weather forecast via a command, delivered as an audio broadcast
* 🤖 **AI-Powered Forecasts** — Optional OpenAI integration generates unique, voiced weather bulletins in any language using GPT-4o-mini and TTS
* 🔐 **Flexible Permission System** — Supports ACE, Steam, MadonnAdmin, or a fully custom permission handler
* 🔔 **Notification System** — Compatible with `default`, `chat`, `MS_Madonne_Notify`, or a custom handler
* 📱 **LB Phone Compatibility** — Native integration with the LB Phone weather app for consistent time, temperature, forecasts, precipitation, and sun times
* 🧩 **Developer Exports** — `GetZonePredictions` and `GetSunTimes` exports for integration with other resources

***

## 🔗 Quick Links

* [📥 Installation](/paid-scripts/madonne-seasons/installation.md)
* [⚙️ Configuration](/paid-scripts/madonne-seasons/configuration.md)
* [💻 Commands](/paid-scripts/madonne-seasons/commands.md)
* [🧩 Exports & Events](/paid-scripts/madonne-seasons/exports-and-events.md)
* [📱 Compatibility](/paid-scripts/madonne-seasons/compatibility.md)
* [❓ Common Errors](/paid-scripts/madonne-seasons/common-errors.md)


---

# 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://documentation.madonnestudio.com/paid-scripts/madonne-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.
